(:source lang=arduino:)

(:sourceend:)

(:include Reference/SerialSeeAlsoIncludes:)

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

• Stream.read()

• Serial.peek()

Serial.read()

Serial1.read()
Serial2.read()
Serial3.read()

Serial.()

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

Serial

read()

Syntax

Serial.read()

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

• Serial.flush()

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

int Serial.read()

an int, the first byte of inocming serial data available (or -1 if no data is available).

• Serial.begin(speed)
• Serial.available()
• Serial.print(data)
• Serial.println(data)

Description

Reads incoming serial data.

Parameters

None

Returns

an int, the first byte of inocming serial data available.

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
• Serial.begin

Reference Home