Serie.ReadStringuntil Arduino -Funktion

Als Arduino -Enthusiast sind Sie vielleicht auf die Serie gestoßen.ReadStringuntil () -Funktion, der ein wesentlicher Bestandteil der Arduino -Serienbibliothek ist. Der Serie.ReadStringuntil () Die Funktion wird verwendet, um Daten aus dem seriellen Port der Arduino -Karte zu lesen, bis ein bestimmtes Zeichen erkannt wird. Mit dieser Funktion können Benutzer mit seriellen Geräten zur Steuerung von Motoren, Sensoren und anderen Peripheriegeräten kommunizieren.

In dieser Beschreibung wird die Serie diskutieren.ReadStringuntil () -Funktion detailliert und umfassen einen Beispielcode dieser Funktion in der Arduino-Programmierung.

Was ist die Serie.ReadStringuntil () -Funktion?

Der Serie.ReadStringuntil () Funktion ist Teil der Serienbibliothek in der Arduino -Programmiersprache. Es wird verwendet, um Daten aus dem seriellen Port der Arduino -Karte zu lesen, bis ein bestimmtes Zeichen erkannt wird. Die Funktion gibt ein String -Objekt zurück, das die vom seriellen Port gelesenen Daten enthält.

Syntax

Die Syntax für die Serie.ReadStringuntil () -Funktion lautet wie folgt:

Serie.ReadStringuntil (char Terminator);

Parameter

Die Funktion nimmt ein einzelnes Argument an, nämlich der Terminatorcharakter.

Terminatorcharakter: Das Charakter, nach dem im empfangenen Datenstrom gesucht werden muss. Erlaubte Datentypen sind verkohlen.

Kehrt zurück

Die Serie.ReadStringuntil () -Funktion gibt die vollständige Zeichenfolge aus, die aus serieller Puffer gelesen wird, sobald das Terminator -Zeichen empfangen wird

Notiz: Die Serie.ReadStringuntil () -Funktion lehnt den Terminatorcharakter ab.

Beispiel Arduino Code

Der folgende Beispielcode erklärt die Arbeit von Serie.ReadStringuntil () Funktion bei der Arduino -Programmierung.

void setup ()
Serie.Beginnen Sie (9600);

void Loop ()
// prüft, ob Daten verfügbar sind, die über den Serienpuffer gelesen werden können
if (seriell.Verfügbar ()> 0)
/* Liest eine Zeichenfolge aus dem seriellen Puffer, bis er auf das Zeichen '\ n' trifft, das das Ende der Zeichenfolge angibt*/
String InputString = Serial.ReadStringuntil ('\ n');
// druckt die empfangene Zeichenfolge in den Serienmonitor
Serie.print ("empfangene Zeichenfolge:");
Serie.println (InputString);

In der Funktion Setup () wird die serielle Kommunikation durch Definieren der Baud -Rate begonnen.

In der Funktion Loop () überprüft die Skizze Daten aus dem seriellen Puffer mithilfe der seriellen.Verfügbar () Funktion. Wenn Daten verfügbar sind, liest in der Skizze eine Zeichenfolge aus dem Serienpuffer, bis sie auf das Zeichen '\ n' mit der Serielle trifft.ReadStringuntil () -Funktion.

Sobald die Zeichenfolge gelesen wurde, wird sie in einer Variablen genannt gespeichert Eingabestring. Schließlich druckt die Skizze die empfangene Zeichenfolge zum Serienmonitor.

Ausgang

In der Ausgabe sehen wir verschiedene Zeichenfolgen, die auf dem Serienmonitor gedruckt sind.

Abschluss

Die Serie.ReadStringuntil () ist eine nützliche Funktion in der Arduino -Programmiersprache, die das Lesen von Strings aus dem seriellen Anschluss ermöglicht, bis ein definierter Terminatorcharakter empfangen wird. Diese Funktion vereinfacht den Prozess der Arbeit mit seriellen Daten. Weitere Informationen zu Serien.ReadStringuntil () Funktion Lesen Sie den Artikel.