Esta página também está disponível em outros 2 idiomas.

Serial.readBytesUntil()

Descrição

Serial.readBytesUntil() lê caracteres da porta serial e os move para um buffer. A função termina se o caractere terminador foi encontrado, se a quantidade de bytes determinada foi lida, ou se ocorre time-out (ver Serial.setTimeout()). A função retorna os caracteres até o último antes do caractere terminador especificado. O caractere terminador não é movido para o buffer.

Serial.readBytesUntil() retorna o número de caracteres colocados no buffer. Um valor 0 indica que dados não foram encontrados.

A função Serial.readBytesUntil() é herdada da classe Stream.

Sintaxe

Serial.readBytesUntil(character, buffer, length)

Parâmetros

Serial: objeto porta serial. Veja a lista de portas seriais disponíveis em cada placa no Serial - Página principal

character : o charactere que encerra a busca (char)

buffer: o buffer para se armazenar os bytes (char[] ou byte[])

length : o número de bytes a serem lidos (int)

Retorna

o número de bytes colocados no buffer (size_t)

Notas e Advertências

O caractere terminador é descartado do buffer serial.

Ver Também

LINGUAGEM Stream
LINGUAGEM Stream.readBytesUntil()