Serial.readBytesUntil()

A Serial.readBytesUntil() beolvassa a karaktereket a soros pufferből egy tömbbe. A függvény akkor fejeződik be (ebben a sorrendben történik az ellenőrzés), ha a meghatározott hosszt beolvasták, ha időtúllépés van (lásd Serial.setTimeout()), vagy ha a lezáró karaktert észleli (Ebben az esetben a függvény visszaadja a karaktereket a megadott lezáró előtti utolsó karakterig). Maga a lezáró nem kerül visszaadáskor a pufferbe.

A Serial.readBytesUntil() a pufferbe beolvasott karakterek számát adja vissza. A 0 azt jelenti, hogy a length paraméter <= 0, időtúllépés történt bármely más bemenet előtt, vagy egy lezáró karakter található bármely más bemenet előtt.

A Serial.readBytesUntil() a stream segédprogram osztályból örökölt.

Serial.readBytesUntil(character, buffer, length)

Serial: soros port objektum. Tekintse meg az egyes kártyákhoz elérhető soros portok listáját a Serial főoldalon.
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.

Adattípus: size_t.

A lezáró karaktert a rendszer eldobja a soros pufferből, kivéve, ha a beolvasott és a pufferbe másolt karakterek száma egyenlő length-tel.