Main

Référence : Langage Arduino : [ Mini | Standard | Etendue | Maxi ] Librairies : [ Vue d'ensemble | Synthèse ] Infos : [ Comparaison | Changements ]
Stream

read()


Description

  • Cette fonction lit les caractères d'un flux de donnée entrant depuis le buffer (ou file d'attente) de stockage.

A savoir : la lecture du caractère a pour effet de vider (ou décaler) la file d'attente d'une position. L'appel suivant de la fonction read() renverra le caractère suivant de la file d'attente, et ainsi de suite...

  • 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.read()

Paramètres

  • stream : tout objet d'une classe utilisant la classe Stream (Serial, Wire, SD, EthernetClient, EthernetServer, ..)

Valeur renvoyée

  • le premier octet (ou caractère) disponible des données entrantes (ou -1 si aucune donnée n'est disponible).

A savoir : la lecture du caractère a pour effet de vider (ou décaler) la file d'attente d'une position. L'appel suivant de la fonction read() renverra le caractère suivant de la file d'attente, et ainsi de suite...

Exemple

Commentaires utilisateurs

  • Si on attend un caractère précis, une des méthode est de lire les caractères jusqu'à ce que l'on obtienne le caractère attendu. Voir également readBytesUntil().

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/StreamRead