NOM

       fgetc, fgets, getc, getchar, ungetc - Saisie de caractères et de chaînes

BIBLIOTHÈQUE

       Bibliothèque C standard (libc, -lc)

SYNOPSIS

       #include <stdio.h>

       int fgetc(FILE *stream);
       int getc(FILE *stream);
       int getchar(void);

       char *fgets(char s[restrict .size], int size, FILE *restrict stream);

       int ungetc(int c, FILE *stream);

DESCRIPTION

       fgetc()  lit  le  caractère  suivant  depuis  le  flux stream et le renvoie sous forme d'un unsigned char
       transformé en int, ou EOF en cas d'erreur ou de fin de fichier.

       getc() est équivalente à fgetc() sauf qu'elle peut être  implémentée  sous  forme  de  macro  qui  évalue
       l'argument stream plusieurs fois.

       getchar() est équivalent à getc(stdin).

       fgets()   reads  in  at  most  one  less than size characters from stream and stores them into the buffer
       pointed to by s. Reading stops after an EOF or a newline. If a newline is read, it  is  stored  into  the
       buffer. A terminating null byte ('\0')  is stored after the last character in the buffer.

       ungetc()  replace  le  caractère  c  dans le flux stream, en le transformant en unsigned char, où il sera
       disponible pour une lecture ultérieure. Les caractères replacés seront  renvoyés  en  ordre  inverse.  Le
       fonctionnement n'est garanti que pour le replacement d'un seul caractère.

       Les fonctions décrites ci-dessus peuvent être utilisées conjointement, ainsi qu'avec les autres fonctions
       de lecture de la bibliothèque stdio pour le même flux d’entrée.

       Pour des versions de ces fonctions ignorant les verrouillages, voir unlocked_stdio(3).

VALEUR RENVOYÉE

       fgetc(),  getc()  et getchar() renvoient un caractère, lu comme un unsigned char et transformé en int, ou
       EOF à la fin du fichier ou en cas d'erreur.

       fgets() renvoie le pointeur s en cas de succès et NULL en cas d'erreur, ou  si  la  fin  de  fichier  est
       atteinte avant d'avoir pu lire au moins un caractère.

       ungetc() renvoie c s'il réussit, ou EOF en cas d'erreur.

ATTRIBUTS

       Pour une explication des termes utilisés dans cette section, consulter attributes(7).
       ┌──────────────────────────────────────────────────────────────────────┬──────────────────────┬─────────┐
       │ Interface                                                            │ Attribut             │ Valeur  │
       ├──────────────────────────────────────────────────────────────────────┼──────────────────────┼─────────┤
       │ fgetc(), fgets(), getc(), getchar(), ungetc()                        │ Sécurité des threads │ MT-Safe │
       └──────────────────────────────────────────────────────────────────────┴──────────────────────┴─────────┘

STANDARDS

       C11, POSIX.1-2008.

HISTORIQUE

       POSIX.1-2001, C89.

NOTES

       Il  est  fortement  déconseillé  de mélanger les appels aux fonctions de lecture de la bibliothèque stdio
       avec les appels aux fonctions de lecture bas niveau read(2) sur le descripteur de fichier associé au flux
       d’entrée. Les résultats sont indéfinis, et très probablement indésirables.

VOIR AUSSI

       read(2), write(2), ferror(3), fgetwc(3), fgetws(3), fopen(3), fread(3),  fseek(3),  getline(3),  gets(3),
       getwchar(3), puts(3), scanf(3), ungetwc(3), unlocked_stdio(3), feature_test_macros(7)

TRADUCTION

       La   traduction   française   de   cette   page   de   manuel   a   été   créée   par  Christophe  Blaess
       <https://www.blaess.fr/christophe/>,   Stéphan   Rafin   <stephan.rafin@laposte.net>,   Thierry   Vignaud
       <tvignaud@mandriva.com>,  François  Micaux,  Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard
       <fevrier@tigreraye.org>,   Jean-Luc   Coulon   (f5ibh)   <jean-luc.coulon@wanadoo.fr>,   Julien   Cristau
       <jcristau@debian.org>,      Thomas      Huriaux      <thomas.huriaux@gmail.com>,     Nicolas     François
       <nicolas.francois@centraliens.net>,    Florentin    Duneau    <fduneau@gmail.com>,     Simon     Paillard
       <simon.paillard@resel.enst-bretagne.fr>,     Denis    Barbier    <barbier@debian.org>,    David    Prévot
       <david@tilapin.org>, Frédéric Hantrais <fhantrais@gmail.com> et Grégoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous  reporter  à  la  GNU General Public License
       version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.

       Si  vous  découvrez  un  bogue  dans la traduction de cette page de manuel, veuillez envoyer un message à
       debian-l10n-french@lists.debian.org.

Pages du manuel de Linux 6.9.1                    15 juin 2024                                          fgetc(3)