Provided by: manpages-fr-dev_3.32d0.2p4-1_all bug

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)