read()

Description

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

Syntax

All boards:

Serial.read()
Serial1.read()


86Duino One specific:

Serial2.read()
Serial3.read()
Serial485.read()


86Duino EduCake specific:

Serial2.read()
Serial3.read()
Serial232.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

－ Serial
－ available()
－ begin()
－ end()
－ find()
－ findUntil()
－ flush()
－ parseFloat()
－ parseInt()
－ peek()
－ print()
－ println()
－ readBytes()
－ readBytesUntil()
－ setTimeout()
－ write()
－ serialEvent()

Language Reference Home

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