Este artigo discutirá a série.ReadStringuntil () Função em profundidade e cobre um código de exemplo dessa função na programação Arduino.
Qual é a série.Função ReadStringuntil ()?
O Serial.ReadStringuntil () A função faz parte da biblioteca serial na linguagem de programação Arduino. É usado para ler dados da porta serial da placa Arduino até que um caractere específico seja detectado. A função retorna um objeto String que contém os dados lidos na porta serial.
Sintaxe
A sintaxe para a série.A função readStringuntil () é a seguinte:
Serial.ReadStringuntil (CHAR Terminator);
Parâmetros
A função leva um único argumento, que é o personagem do Terminator.
Personagem do Terminator: O personagem a procurar no fluxo de dados recebido. Os tipos de dados permitidos são Caracteres.
Retorna
A série.Função readstringuntil () retorna a string completa lida do tampão serial assim que o caractere do Terminator for recebido
Observação: A série.ReadStringuntil () descarta o caractere do Terminator.
Exemplo de código Arduino
A seguir o código de exemplo explica o funcionamento de Serial.ReadStringuntil () função na programação arduino.
Void Setup ()
Serial.começar (9600);
Void Loop ()
// verifica se há algum dado disponível para serem lidos no buffer serial
se (serial.disponível ()> 0)
/* Lê uma string do buffer serial até encontrar o caractere '\ n', que indica o final da string*/
String inputString = serial.readstringuntil ('\ n');
// imprime a string recebida no monitor serial
Serial.print ("String recebida:");
Serial.println (inputString);
Na função Setup (), a comunicação serial é iniciada definindo a taxa de transmissão.
Na função loop (), o esboço verifica os dados do buffer serial usando o serial.Função disponível (). Se houver dados disponíveis, o esboço lê uma string do buffer serial até encontrar o personagem '\ n' usando o serial.Função ReadStringuntil ().
Uma vez lido a string, ela é armazenada em uma variável chamada inputString. Finalmente, o esboço imprime a string recebida no monitor serial.
Saída
Na saída, podemos ver strings diferentes impressas no monitor serial.
Conclusão
A série.ReadStringuntil () é uma função útil na linguagem de programação Arduino que permite a leitura de cordas da porta serial até que um caractere de terminador definido seja recebido. Esta função simplifica o processo de trabalho com dados seriais. Para mais detalhes sobre série.Função ReadStringuntil () Leia o artigo.