NOM

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

SYNOPSIS

       #include <stdio.h>

       int fgetc(FILE *stream);

       char *fgets(char *s, int size, FILE *stream);

       int getc(FILE *stream);

       int getchar(void);

       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 équivalent à fgetc() sauf qu'il peut être implémenté sous forme de  macro,  qui
       évalue l'argument stream plusieurs fois.

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

       fgets()  lit  au plus size - 1 caractères depuis stream et les place dans le tampon pointé
       par s. La lecture s'arrête après EOF ou un retour chariot. Si un retour chariot  (newline)
       est  lu, il est placé dans le tampon. Un octet nul (« \0 ») final est placé à la fin de la
       ligne.

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

       gets()  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.

CONFORMITÉ

       C89, C99, POSIX.1-2001.

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

COLOPHON

       Cette  page  fait partie de la publication 3.57 du projet man-pages Linux. Une description
       du projet et des  instructions  pour  signaler  des  anomalies  peuvent  être  trouvées  à
       l'adresse http://www.kernel.org/doc/man-pages/.

TRADUCTION

       Depuis    2010,    cette   traduction   est   maintenue   à   l'aide   de   l'outil   po4a
       <http://po4a.alioth.debian.org/> par l'équipe de traduction francophone au sein du  projet
       perkamon <http://perkamon.alioth.debian.org/>.

       Veuillez     signaler     toute     erreur     de     traduction     en     écrivant     à
       <debian-l10n-french@lists.debian.org>  ou  par  un  rapport  de  bogue   sur   le   paquet
       manpages-fr.

       Vous  pouvez  toujours  avoir  accès  à la version anglaise de ce document en utilisant la
       commande « man -L C <section> <page_de_man> ».