Provided by:
manpages-fr-dev_3.32d0.2p4-1_all 
NOM
stdio - Bibliotheque standard de fonctions d'entrees-sorties
SYNOPSIS
#include <stdio.h>
FILE *stdin;
FILE *stdout;
FILE *stderr;
DESCRIPTION
Cette bibliotheque standard fournit une interface simple et efficace
pour les entrees-sorties avec tampons. Les entrees et les sorties sont
projetees dans des flux de donnees logiques, et les caracteristiques
des entrees-sorties physiques sont masquees. Les fonctions et les
macros sont presentees rapidement ci-dessous. Des informations
supplementaires sont disponibles dans leurs pages de manuel
individuelles.
Un flux est associe avec un fichier externe (qui peut aussi etre un
dispositif physique) en ouvrant un fichier (ceci peut impliquer la
creation d'un nouveau fichier). La creation d'un fichier deja existant
efface son contenu precedent. Si un fichier supporte les demandes de
positionnement (par exemple un fichier sur disque, contrairement a un
terminal), alors l'indicateur de position du fichier associe au flux
est place au debut du fichier (octet zero), a moins que le fichier soit
ouvert en mode d'ajout. Si le mode d'ajout est utilise, l'indicateur de
position est place a la fin du fichier. L'indicateur de position est
mis a jour apres chaque lecture, ecriture, ou repositionnement. Toutes
les entrees se deroulent comme si les caracteres etaient lus par des
appels successifs a la fonction fgetc(3). Toutes les sorties ont lieu
comme si les caracteres etaient envoyes a des appels successifs a la
fonction fputc(3).
Un fichier est dissocie d'un flux en fermant le fichier. Les flux de
sortie sont vides (flush) avant que le flux soit dissocie du fichier.
Ceci signifie que le contenu des tampons pas encore ecrits est
transfere dans l'environnement de l'hote. La valeur d'un pointeur sur
un objet FILE (fichier) est indefinie apres la fermeture d'un fichier.
Un fichier peut etre reouvert plus tard par le meme programme ou par un
autre, et son contenu relu ou modifie (si l'on peut placer l'indicateur
de positionnement au debut). Si la fonction main() se termine, ou si la
fonction exit(3) est invoquee, tous les fichiers sont fermes (tous les
tampons de sortie sont transferes par fflush) avant la fin du
programme. Les autres methodes d'abandon du programme, telles que
abort(3) ne s'occupent pas de fermer proprement les fichiers.
Au demarrage du programme, trois flux de texte sont predefinis et n'ont
pas besoin d'etre ouverts explicitement : l'entr'ee standard (pour la
lecture des donnees), la sortie standard (pour l'ecriture des donnees),
et le flux d'erreur standard (pour les messages de diagnostique). Ces
flux sont nommes stdin,stdout et stderr. A l'ouverture, le flux
d'erreur n'a pas de tampon, l'entree standard et la sortie standard ont
des tampons complets si et seulement si ils ne se referent pas a un
peripherique interactif.
Les flux de sortie qui s'adressent a un peripherique terminal disposent
toujours d'un tampon de ligne par defaut. Les caracteres sont conserves
dans le tampon jusqu'a un saut de ligne, ou jusqu'a ce qu'une lecture
soit demandee sur un flux associe au meme terminal. Il peut etre
necessaire de declencher intentionnellement l'ecriture effective sur le
terminal en invoquant fflush(3).
La bibliotheque standard stdio fait partie de la bibliotheque libc et
ses routines sont chargees automatiquement par les compilateurs cc(1)
et pc(1) si besoin est. Les sections SYNOPSIS des pages de manuel
mentionnees plus bas indiquent les fichiers d'en-tete necessaires,
l'allure des declarations de fonctions, et les variables externes
utiles.
Les noms ci-dessous correspondent a des macros. On ne peut pas les
reutiliser sans supprimer leur definition precedente avec #undef:
BUFSIZ, EOF, FILENAME_MAX, FOPEN_MAX, L_cuserid, L_ctermid, L_tmpnam,
NULL, SEEK_END, SEEK_SET, SEEK_CUR, TMP_MAX, clearerr, feof, ferror,
fileno, getc, getchar, putc, putchar, stderr, stdin, stdout. Il existe
des definitions sous forme de fonctions des macros feof, ferror,
clearerr, fileno, getc, getchar, putc, et putchar qui seront utilisees
si la definition de la macro est explicitement supprimee.
Liste des fonctions
Fonction Description
----------------------------------------------------------------
clearerr verifie et reinitialise l'etat d'un flux.
fclose ferme un flux.
fdopen fonction d'ouverture d'un flux.
feof verifie et reinitialise l'etat d'un flux.
ferror verifie et reinitialise l'etat d'un flux.
fflush transfere les tampons d'un flux.
fgetc lit le caractere ou le mot suivant depuis un flux
d'entree.
fgetpos repositionner un flux.
fgets lit une ligne depuis un flux d'entree.
fileno renvoie le descripteur (de type entier) du flux
fourni en parametre.
fopen fonction d'ouverture d'un flux.
fprintf ecriture de donnees formatees.
fpurge transfere les tampons d'un flux.
fputc ecriture d'un caractere ou d'un mot dans un flux.
fputs ecriture d'une ligne dans un flux.
fread entrees-sorties binaires.
freopen fonction d'ouverture d'un flux.
fscanf lecture de donnees formatees.
fseek repositionner un flux.
fsetpos repositionner un flux.
ftell repositionner un flux.
fwrite entrees-sorties binaires.
getc lit le caractere ou le mot suivant depuis un flux
d'entree.
getchar lit le caractere ou le mot suivant depuis un flux
d'entree.
gets lit une ligne depuis un flux d'entree.
getw lit le caractere ou le mot suivant depuis un flux
d'entree.
mktemp creer un fichier temporaire (unique).
perror messages d'erreur systeme.
printf ecriture de donnees formatees.
putc ecriture d'un caractere ou d'un mot dans un flux.
putchar ecriture d'un caractere ou d'un mot dans un flux.
puts ecriture d'une ligne dans un flux.
putw ecriture d'un caractere ou d'un mot dans un flux.
remove supprimer une entree de repertoire.
rewind repositionner un flux.
scanf lecture de donnees formatees.
setbuf operations sur les tampons.
setbuffer operations sur les tampons.
setlinebuf operations sur les tampons.
setvbuf operations sur les tampons.
sprintf ecriture de donnees formatees.
sscanf lecture de donnees formatees.
strerror messages d'erreur systeme.
sys_errlist messages d'erreur systeme.
sys_nerr messages d'erreur systeme.
tempnam creer un fichier temporaire.
tmpfile creer un fichier temporaire.
tmpnam creer un fichier temporaire.
ungetc remettre un caractere dans un flux d'entree.
vfprintf ecriture de donnees formatees.
vfscanf lecture de donnees formatees.
vprintf ecriture de donnees formatees.
vscanf lecture de donnees formatees.
vsprintf ecriture de donnees formatees.
vsscanf lecture de donnees formatees.
CONFORMIT'E
La bibliotheque stdio est conforme a C89.
VOIR AUSSI
close(2), open(2), read(2), write(2), stdout(3), unlocked_stdio(3)
COLOPHON
Cette page fait partie de la publication 3.32 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). Nicolas
Francois 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> >>.
26 decembre 2001 STDIO(3)