NOM
stdin, stdout, stderr - Flux d’entrées-sorties standard
SYNOPSIS
#include <stdio.h>
extern FILE *stdin;
extern FILE *stdout;
extern FILE *stderr;
Normalement, tout programme Unix démarre avec trois flux déjà ouverts,
l’un pour l’entrée des données, un autre pour la sortie des données, et
un troisième pour l’affichage des messages de diagnostic ou d’erreur.
Ces trois flux sont typiquement attachés au terminal de l’utilisateur
(voir tty(4)), mais peuvent également être redirigés vers des fichiers
ou vers d’autres périphériques suivant les choix du processus parent
(voir le paragraphe « Redirection » dans sh(1)).
Le flux d’entrée est appelé « entrée standard » (standard input), le
flux de sortie « sortie standard » (standard output), et le flux
d’erreur est souvent appelé « erreur standard » (standard error). Ces
noms sont abrégés dans les dénominations symboliques de ces fichiers :
stdin, stdout et stderr.
Chacun de ces symboles est une macro de stdio(3) de type pointeur sur
un FILE, et peut être utilisé dans des fonctions comme fprintf(3) ou
fread(3).
Comme les FILE sont simplement des coquilles entourant les descripteurs
de fichiers en ajoutant une mémoire tampon, il est également possible
d’accéder aux fichiers Unix « bruts », avec des fonctions comme read(2)
et lseek(2).
Au démarrage du programme, les descripteurs de fichier associés aux
flux stdin, stdout et stderr valent respectivement 0, 1 et 2. Les
constantes symboliques STDIN_FILENO, STDOUT_FILENO, et STDERR_FILENO
sont définies avec ces valeurs dans <unistd.h> (appliquer freopen(3)
sur l’un de ces flux peut modifier le numéro de descripteur de fichier
associé au flux).
Notez que l’utilisation conjointe des FILE et des descripteurs bruts
risque de produire des résultats inattendus, et doit être généralement
évitée. Pour les plus masochistes d’entre-vous, POSIX.1 décrit en
détail, dans son paragraphe 8.2.3, comment ces interactions sont
censées fonctionner. Une règle générale est que les descripteurs de
fichier sont manipulés par le noyau, alors que stdio est simplement une
bibliothèque. Ceci signifie par exemple qu’après un exec(3), le
processus fils hérite de tous les descripteurs de fichier ouverts, mais
que les flux deviennent inaccessibles.
Les symboles stdin, stdout et stderr étant définis comme des macros, il
est interdit de leur assigner une valeur. On peut utiliser la fonction
de bibliothèque freopen(3), spécialement conçue pour réassigner stdin,
stdout et stderr. Les flux standard sont fermés lors d’un appel à
exit(3) ou lors d’une fin normale de programme.
CONFORMITÉ
Les macros stdin, stdout et stderr sont conformes au standard C89, et
celui-ci stipule également que ces trois flux doivent être ouverts au
démarrage du programme.
NOTES
Le flux stderr n’a pas de tampon. Le flux stdout a un tampon de ligne
lorsqu’il est dirigé vers un terminal. Les lignes partielles
n’apparaîtront pas avant que fflush(3) ou exit(3) ne soient invoquées,
ou qu’un retour-chariot soit écrit. Ceci a parfois des effets
inattendus, principalement lors du débogage des programmes. La gestion
des tampons des flux standard (et des autres flux également) peut être
modifiée en utilisant setbuf(3) ou setvbuf(3). Remarquez que dans le
cas où stdin est associée à un terminal, il peut également y avoir un
tampon d’entrée dans le pilote de terminal, sans aucune relation avec
le tampon de stdio (en effet, normalement, la saisie depuis un terminal
est gérée avec un tampon de ligne dans le noyau). Cette gestion par le
noyau peut être configurée en utilisant des appels système comme
tcsetattr(3). Voir également stty(1) et termios(3).
VOIR AUSSI
csh(1), sh(1), open(2), fopen(3), stdio(3)
COLOPHON
Cette page fait partie de la publication 3.23 du projet man-pages
Linux. Une description du projet et des instructions pour signaler des
anomalies peuvent être trouvées à l’adresse
http://www.kernel.org/doc/man-pages/.
TRADUCTION
Cette page de manuel a été traduite et mise à jour par Christophe
Blaess <http://www.blaess.fr/christophe/> entre 1996 et 2003, puis par
Alain Portal <aportal AT univ-montp2 DOT fr> jusqu’en 2006, et mise à
disposition sur http://manpagesfr.free.fr/.
Les mises à jour et corrections de la version présente dans Debian sont
directement gérées par Nicolas François
<nicolas.francois@centraliens.net> et l’équipe francophone de
traduction de Debian.
Veuillez signaler toute erreur de traduction en écrivant à
<debian-l10n-french@lists.debian.org> ou par un rapport de bogue sur le
paquet manpages-fr.
Vous pouvez toujours avoir accès à la version anglaise de ce document
en utilisant la commande « man -L C <section> <page_de_man> ».