Home Page | Language Reference (extended) | SD Reference | Libraries | Comparison | Changes

Serial

read()

Description

Reads incoming serial data. read() inherits from the Stream utility class.

Syntax

Serial.read()

Arduino Mega only:
Serial1.read()
Serial2.read()
Serial3.read()

Parameters

None

Returns

the first byte of incoming serial data available (or -1 if no data is available) - int

Example

int incomingByte = 0 ;   // for incoming serial data void setup ( ) {
        Serial.begin ( 9600 ) ;     // opens serial port, sets data rate to 9600 bps
} void loop ( ) {         // send data only when you receive data:
        if ( Serial.available ( ) > 0 ) {
                // read the incoming byte:
                incomingByte = Serial.read ( ) ;                 // say what you got:
                Serial.print ( "I received: " ) ;
                Serial.println (incomingByte, DEC ) ;
        }
}

See also

• begin()
• end()
• available()
• read()
• peek()
• parseInt()
• flush()
• print()
• println()
• write()
• SerialEvent()
  
• Stream.read()

Reference Home

Corrections, suggestions, and new documentation should be posted to the Forum.

The text of the Arduino reference is licensed under a Creative Commons Attribution-ShareAlike 3.0 License. Code samples in the reference are released into the public domain.