This page is also available in 3 other languages

Serial.readBytes()

Description

Serial.readBytes() reads characters from the serial port into a buffer. The function terminates if the determined length has been read, or it times out (see Serial.setTimeout()).

Serial.readBytes() returns the number of characters placed in the buffer. A 0 means no valid data was found.

Serial.readBytes() inherits from the Stream utility class.

Syntax

Serial.readBytes(buffer, length)

Parameters

Serial: serial port object. See the list of available serial ports for each board on the Serial main page.
buffer: the buffer to store the bytes in. Allowed data types: or array of char or byte`s.
`length
: the number of bytes to read. Allowed data types: int.

Returns

The number of bytes placed in the buffer. Data type: size_t.

See also