Main

Référence : Langage Arduino : [ Mini | Standard | Etendue | Maxi ] Librairies : [ Vue d'ensemble | Synthèse ] Infos : [ Comparaison | Changements ]
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 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

stream.readBytesUntil(character, buffer, length)

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)

Valeur renvoyée

  • 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.

Exemple

Commentaires utilisateurs

Aucun commentaire


Page d'accueil de la référence Arduino en français

Corrections, suggestions et nouvelle documentation peuvent être postées sur le Forum Arduino ou à l'adresse suivante : support_at_mon-club-elec_point_fr

Le texte original de la référence Arduino est sous licence Creative Commons Attribution-ShareAlike 3.0 . Les exemples de code dans la référence sont dans le domaine public.

La présente traduction française commentée a été réalisée par Xavier HINAULT (2010-2012) (www.mon-club-elec.fr) et est sous licence Creative Commons Attribution-ShareAlike 3.0.

Cette page est la traduction française par X. HINAULT de la page originale : http://arduino.cc/en/Reference/StreamReadBytesUntil