Stream.readBytesUntil()

Descrição

readBytesUntil() lê bytes de uma stream para um buffer. A função termina se o carctere terminador é encontrado, o número de bytes determinado foi lido, ou ocorre time-out (ver setTimeout()). A função retorna o caractere até o último caractere antes o terminador fornecido. O terminador em si não é retornado no buffer.

readBytesUntil() retorna o número de bytes colocados no buffer. Um valor 0 indica que não foram encontrados dados válidos.

Essa função é parte da classe Stream, e pode ser chamada por qualquer classe que herda da mesma (Wire, Serial, etc). Veja a página principal da classe Stream para mais informações.

Sintaxe

stream.readBytesUntil(character, buffer, length)

Parâmetros

  • stream : uma instância de uma classe que herda da classe Stream.
  • character : o caractere para encerra a busca (char)
  • buffer: o buffer para 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.

※ Notas e Advertências:

O caractere terminador é descartado do buffer serial.

Ver Também

ARDUINO BUY RECOMMENDATION

Arduino UNO R3
Arduino Starter Kit
Please note: These are Amazon affiliate links. If you buy the components through these links, We will get a commission at no extra cost to you. We appreciate it.

※ OUR MESSAGES