fgetc(3)                   Library Functions Manual                   fgetc(3)

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

BIBLIOTHEQUE
       Bibliotheque 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 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 equivalente a fgetc() sauf qu'elle peut etre implementee
       sous forme de macro qui evalue l'argument stream plusieurs fois.

       getchar() est equivalent a getc(stdin).

       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 est lu, il est place dans le tampon. Un
       octet NULL final (<< \0 >>) est place apres le dernier caractere dans
       le tampon.

       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 le meme flux d'entree.

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

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

       fgets() renvoie le pointeur s en cas de succes 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.

ATTRIBUTS
       Pour une explication des termes utilises dans cette section, consulter
       attributes(7).

       +---------------------------------+--------------------------+---------+
       |Interface                        | Attribut                 | Valeur  |
       +---------------------------------+--------------------------+---------+
       |fgetc(), fgets(), getc(),        | Securite des threads     | MT-Safe |
       |getchar(), ungetc()              |                          |         |
       +---------------------------------+--------------------------+---------+
STANDARDS
       C11, POSIX.1-2008.

HISTORIQUE
       POSIX.1-2001, C89.

NOTES
       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 d'entree. 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), gets(3), getwchar(3), puts(3), scanf(3),
       ungetwc(3), unlocked_stdio(3), feature_test_macros(7)

TRADUCTION
       La traduction francaise de cette page de manuel a ete creee par
       Christophe Blaess <https://www.blaess.fr/christophe/>, Stephan Rafin
       <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>,
       Francois Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe
       Guerard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-
       luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas
       Huriaux <thomas.huriaux@gmail.com>, Nicolas Francois
       <nicolas.francois@centraliens.net>, Florentin Duneau
       <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-
       bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prevot
       <david@tilapin.org>, Frederic Hantrais <fhantrais@gmail.com> et
       Gregoire Scano <gregoire.scano@malloc.fr>

       Cette traduction est une documentation libre ; veuillez vous reporter a
       la GNU General Public License version 3
       <https://www.gnu.org/licenses/gpl-3.0.html> concernant les conditions
       de copie et de distribution. Il n'y a aucune RESPONSABILITE LEGALE.

       Si vous decouvrez un bogue dans la traduction de cette page de manuel,
       veuillez envoyer un message a <debian-l10n-french@lists.debian.org>.

Pages du manuel de Linux 6.06   31 octobre 2023                       fgetc(3)