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)
Código de Exemplo
const int BUFFER_SIZE = 100;
char buf[BUFFER_SIZE];
void setup() {
Serial.begin(9600); // opens serial port, sets data rate to 9600 bps
}
void loop() {
// check if data is available
if (Serial.available() > 0) {
// read the incoming bytes:
int rlen = Serial.readBytesUntil('\n', buf, BUFFER_SIZE);
// prints the received data
Serial.print("I received: ");
for(int i = 0; i < rlen; i++)
Serial.print(buf[i]);
}
}
- Select Newline at the ending selection of Serial Monitor
- Type "HELLO" on Serial Monitor
- Click Send button:
COM6
Autoscroll
Clear output
9600 baud
Newline
- The result on Serial Monitor:
COM6
I received: HELLO
Autoscroll
Clear output
9600 baud
Newline
※ Notas e Advertências:
- O caractere terminador é descartado do buffer serial.
- Serial functions are not only used for the communication between an Arduino board and Serial Monitor of Arduino IDE but also used for the communication between:
- An Arduino board and other Arduino board
- An Arduino board and other sensors/devices
- An Arduino board and computer (any Serial software on computer)
Ver Também
- Linguagem : Arduino - Serial
- Linguagem : Serial.available()
- Linguagem : Serial.availableForWrite()
- Linguagem : Serial.begin()
- Linguagem : Serial.end()
- Linguagem : Serial.find()
- Linguagem : Serial.findUntil()
- Linguagem : Serial.flush()
- Linguagem : Serial.getTimeout()
- Linguagem : if(Serial)
- Linguagem : Serial.parseFloat()
- Linguagem : Serial.parseInt()
- Linguagem : Serial.peek()
- Linguagem : Serial.print()
- Linguagem : Serial.println()
- Linguagem : Serial.read()
- Linguagem : Serial.readBytes()
- Linguagem : Serial.readString()
- Linguagem : Serial.readStringUntil()
- Linguagem : serialEvent()
- Linguagem : Serial.setTimeout()
- Linguagem : Serial.write()
※ ARDUINO BUY RECOMMENDATION
| Arduino UNO R3 | |
| Arduino Starter Kit |
Disclosure: Some links in this section are Amazon affiliate links. If you make a purchase through these links, we may earn a commission at no extra cost to you.
Additionally, some links direct to products from our own brand, DIYables .
Additionally, some links direct to products from our own brand, DIYables .