#include <stdio.h>

extern FILE *stdin;
extern FILE *stdout;
extern FILE *stderr;

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 FILEs 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) ou lseek(2). Au démarrage du programme, les descripteurs des fichiers associés aux flux stdin, stdout et stderr sont 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 FILEs 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 fichiers sont manipulés par le noyau, alors que stdio est simplement une bibliothèque. Ceci signifie par exemple qu'après un exec(), le processus fils hérite de tous les descripteurs de fichiers ouverts, mais que les flux deviennent inaccessibles.

Comme les symboles stdin, stdout et stderr sont définis comme des macros, il est interdit de leur assigner une valeur. On peut utiliser la fonction de bibliothèque freopen(3) pour réassigner les flux standards de manière portable.

Les flux standards sont fermés lors d'un appel à exit(3), ou lors d'une fin normale de programme.  

Ceci a parfois des effets inattendus, principalement lors du débogage des programmes. La gestion des tampons des flux standards (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 fait, 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) ou termios(3).  

Ce document est une traduction réalisée par Christophe Blaess <http://www.blaess.fr/christophe/> le 30 avril 1998 et révisée le 29 décembre 2007.

L'équipe de traduction a fait le maximum pour réaliser une adaptation française de qualité. La version anglaise la plus à jour de ce document est toujours consultable via la commande : « LANG=C man 3 stdin ». N'hésitez pas à signaler à l'auteur ou au traducteur, selon le cas, toute erreur dans cette page de manuel.

NOM

SYNOPSIS

DESCRIPTION

CONFORMITÉ

NOTES

VOIR AUSSI

TRADUCTION