Ten pismo omówi serial.funkcja readStringuntil () dogłębna i omówi przykładowy kod tej funkcji w programowaniu Arduino.
Co to jest serial.funkcja readStringuntil ()?
Seryjny.readStringuntil () Funkcja jest częścią biblioteki szeregowej w języku programowania Arduino. Służy do odczytu danych z portu szeregowego płyty Arduino do momentu wykrycia określonego znaku. Funkcja zwraca obiekt ciągów zawierający odczytane dane z portu szeregowego.
Składnia
Składnia dla szeregowego.Funkcja ReadStringUntil () jest następująca:
Seryjny.ReadStringuntil (Char Terminator);
Parametry
Funkcja przyjmuje pojedynczy argument, który jest znakiem terminatora.
Postać terminatora: Znak do wyszukiwania w otrzymanym strumieniu danych. Dozwolone są typy danych zwęglać.
Zwroty
Serial.funkcja readStringuntil () zwraca pełny ciąg odczytu z bufora szeregowego po otrzymaniu znaku terminatora
Notatka: Serial.Funkcja ReadStringuntil () odrzuca znak terminatora.
Przykład kodu Arduino
Poniższy przykład kod wyjaśnia działanie Seryjny.readStringuntil () Funkcja w programowaniu Arduino.
void setup ()
Seryjny.rozpocząć (9600);
void Loop ()
// sprawdza, czy są dostępne dane do odczytania z bufora szeregowego
if (serial.Dostępne ()> 0)
/* Odczytuje ciąg z bufora szeregowego, aż napotknie znak „\ n”, który wskazuje koniec ciągu*/
String InputString = szeregowy.readStringUntil („\ n”);
// drukuje odebrany ciąg do monitora szeregowego
Seryjny.print („Otrzymano ciąg:”);
Seryjny.println (InputString);
W funkcji Setup () komunikacja szeregowa rozpoczyna się od zdefiniowania szybkości transmisji.
W funkcji Loop () szkic sprawdza dane z bufora szeregowego za pomocą szeregowego.dostępna () funkcja. Jeśli dostępne są dane, szkic odczytuje ciąg z bufora szeregowego, dopóki nie napotknie znaku „\ n” za pomocą szeregowego.funkcja readStringuntil ().
Po odczytaniu ciągu jest przechowywany w zmiennej nazywanej wejście. Wreszcie szkic drukuje otrzymany ciąg do monitora szeregowego.
Wyjście
W wyjściu możemy zobaczyć różne struny wydrukowane na monitorze szeregowym.
Wniosek
Serial.ReadStringUntil () jest przydatną funkcją w języku programowania Arduino, która pozwala na odczytanie ciągów z portu szeregowego, dopóki nie zostanie odebrany zdefiniowany znak terminatora. Ta funkcja upraszcza proces pracy z danymi szeregowymi. Aby uzyskać więcej informacji na temat serialu.funkcja readStringuntil () Przeczytaj artykuł.