Provided by: manpages-fr-dev_3.27fr1.4-1_all bug

NOM

       gets,  fgetc, fgets, getc, getchar, ungetc - Saisie de caracteres et de
       chaines

SYNOPSIS

       #include <stdio.h>

       int fgetc(FILE *stream);

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

       int getc(FILE *stream);

       int getchar(void);

       char *gets(char *s);

       int ungetc(int c, FILE *stream);

DESCRIPTION

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

       getc() est equivalent a fgetc() sauf qu'il peut  etre  implemente  sous
       forme de macro, qui evalue l'argument stream plusieurs fois.

       getchar() est equivalent a getc(stdin).

       gets() lit une ligne depuis stdin et la place dans le tampon pointe par
       s jusqu'a atteindre un retour-chariot, ou EOF, qu'il remplace par '\0'.
       Il  n'y a pas de verification de debordement de tampon (voir la section
       des BOGUES plus bas).

       fgets() lit au plus size - 1 caracteres depuis stream et les place dans
       le   tampon  pointe  par  s.  La  lecture  s'arrete  apres  EOF  ou  un
       retour-chariot. Si un retour-chariot (newline) est  lu,  il  est  place
       dans le tampon. Un caractere nul '\0' est place a la fin de la ligne.

       ungetc() replace le caractere c dans le flux stream, en le transformant
       en unsigned char, ou il sera disponible pour  une  lecture  ulterieure.
       Les   caracteres   replaces   seront  renvoyes  en  ordre  inverse.  Le
       fonctionnement  n'est  garanti  que  pour  le  replacement  d'un   seul
       caractere.

       Les  fonctions decrites ci-dessus peuvent etre utilisees conjointement,
       ainsi qu'avec les autres fonctions de lecture de la bibliotheque stdio.

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

VALEUR RENVOY'EE

       fgetc(),  getc()  et  getchar()  renvoient  un  caractere,  lu comme un
       unsigned char, et transforme en int, ou EOF a la fin du fichier, ou  en
       cas d'erreur.

       gets() et fgets() renvoient le pointeur s si elles reussissent, et NULL
       en cas d'erreur, ou si la fin de fichier est atteinte avant d'avoir  pu
       lire au moins un caractere.

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

CONFORMIT'E

       C89,  C99,  POSIX.1-2001.  LSB  marque  gets()  comme  etant  obsolete.
       POSIX.1-2008 supprime la specification de gets().

BOGUES

       N'utilisez jamais gets(). Comme il est impossible de savoir a  l'avance
       combien  de  caracteres seront lus par gets(), et comme celui-ci ecrira
       tous les caracteres lus, meme s'ils debordent du tampon, cette fonction
       est   extremement   dangereuse   a  utiliser.  On  a  deja  utilise  ce
       dysfonctionnement pour creer des trous de securite.  UTILISEZ  TOUJOURS
       fgets() A LA PLACE DE gets().

       Il  est  fortement  deconseille de melanger les appels aux fonctions de
       lecture de la bibliotheque stdio  avec  les  appels  aux  fonctions  de
       lecture  bas-niveau  read(2)  sur  le descripteur de fichier associe au
       flux. Les resultats sont indefinis, et tres probablement indesirables.

VOIR AUSSI

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

COLOPHON

       Cette page fait partie de  la  publication  3.27  du  projet  man-pages
       Linux.  Une description du projet et des instructions pour signaler des
       anomalies      peuvent      etre       trouvees       a       l'adresse
       <URL:http://www.kernel.org/doc/man-pages/>.

TRADUCTION

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

       Christophe Blaess  <URL:http://www.blaess.fr/christophe/>  (1996-2003),
       Alain  Portal  <URL:http://manpagesfr.free.fr/> (2003-2006).  Florentin
       Duneau et l'equipe francophone de traduction de Debian (2006-2009).

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

       Vous pouvez toujours avoir acces a la version anglaise de  ce  document
       en utilisant la commande << man -L C <section> <page_de_man> >>.

GNU                               6 aout 2008                          GETS(3)