Description :
Serial.readBytesUntil() lit les caractères du tampon série dans un tableau. La fonction se termine (les vérifications étant effectuées dans cet ordre) si la longueur déterminée a été lue, si elle expire ( voir Serial.setTimeout() ), ou si le caractère de fin est détecté (auquel cas la fonction renvoie les caractères jusqu’à le dernier caractère avant le terminateur fourni). Le terminateur lui-même n’est pas renvoyé dans le tampon.
Serial.readBytesUntil() renvoie le nombre de caractères lus dans le tampon. Un 0 signifie que le length paramètre <= 0, qu’un délai d’attente s’est produit avant toute autre entrée ou qu’un caractère de fin a été trouvé avant toute autre entrée.
Serial.readBytesUntil() hérite de la classe utilitaire Stream .
Syntaxe
Serial.readBytesUntil(character, buffer, length)
Paramètres :
Serial : objet port série. Consultez la liste des ports série disponibles pour chaque carte sur la page principale Serial .
character : le caractère à rechercher. Types de données autorisés : char .
buffer : le tampon dans lequel stocker les octets. Types de données autorisés : tableau de char ou byte .
length : le nombre d’octets à lire. Types de données autorisés : int .
Retour :
Type de données : size_t .
Remarques et avertissements :
Le caractère de fin est supprimé du tampon série, sauf si le nombre de caractères lus et copiés dans le tampon est égal à length .
Source : https://www.arduino.cc/reference/en/language/functions/communication/serial/readbytesuntil/
