Provided by:
manpages-fr-dev_3.27fr1.4-1_all 
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)