stream.readBytesUntil()

Leírás

A readBytesUntil() beolvassa a karaktereket egy adatfolyamból egy pufferbe. A függvény akkor fejeződik be, ha a lezáró karaktert észleli, ha a meghatározott hossz kiolvasásra került, vagy ha túllépi az időt (lásd stream.setTimeout()). A függvény visszaadja a karaktereket a megadott lezáró előtti utolsó karakterig. Maga a lezáró nem kerül vissza a pufferbe.

A readBytesUntil() a pufferben elhelyezett bájtok számát adja vissza. A 0 azt jelenti, hogy nem található érvényes adat.

Ez a függvény a stream osztály része, és bármely osztály meghívhatja, amely örököli (Wire, Serial stb.). További információkért tekintse meg a stream osztály főoldalát.

Szintaxis

stream.readBytesUntil(character, buffer, length)

Paraméterek

stream: a stream osztálytól örökölt példány.
character: a keresendő karakter. Engedélyezett adattípusok: char
buffer: a puffer a bájtok tárolására. Engedélyezett adattípusok: char vagy byte tömb.
length: az olvasandó bájtok száma. Engedélyezett adattípusok: int.

Visszatérési érték

A pufferben elhelyezett bájtok száma. Adattípus: size_t

Megjegyzések és figyelmeztetések

A lezáró karakter kikerül a folyamból.