Stream.readBytesUntil()

Description

Cette fonction lit les caractères d'un flux de données et les met dans une variable de stockage (buffer). La fonction s'arrête si le caractère de fin a été trouvé, si la longueur de chaîne voulue (c'est à dire le nombre de caractères voulu) a été lu, ou si le temps limite est écoulé. Voir la fonction Stream.setTimeout().

Cette fonction renvoie le nombre de caractères qui ont été stockés dans la variable buffer. 0 signifie qu'aucune donnée valide n'a été trouvée.

Cette fonction fait partie de la classe Stream et est appelée par toute classe qui en dépend (Wire, Serial, etc...). Voir la page principale de la classe Stream pour plus de détails.

Syntaxe

Paramètres

• stream: tout objet d'une classe utilisant la classe Stream (Serial, Wire, SD, EthernetClient, EthernetServer, ..)
• character: le caractère de fin à rechercher (char)
• buffer: la variable de stockage des octets entrants (tableau de char[] ou de byte[])
• length: le nombre d'octets (ou caractères) à lire (int)

Valeurs Renvoyées

• Byte : Cette fonction renvoie le nombre de caractères qui ont été stockés dans la variable buffer. 0 signifie qu'aucune donnée valide n'a été trouvée.