table of contents
- trixie 4.27.0-1
- trixie-backports 4.31.0-1~bpo13+1
- testing 4.32.4-1
- unstable 4.32.4-1
| stdin(3) | Library Functions Manual | stdin(3) |
NOM¶
stdin, stdout, stderr - Flux d'entrées-sorties standard
BIBLIOTHÈQUE¶
Bibliothèque C standard (libc, -lc)
SYNOPSIS¶
#include <stdio.h>
extern FILE *stdin; extern FILE *stdout; extern FILE *stderr;
DESCRIPTION¶
Under normal circumstances every UNIX program has three streams opened for it when it starts up, one for input, one for output, and one for printing diagnostic or error messages. These are typically attached to the user's terminal (see tty(4)) but might instead refer to files or other devices, depending on what the parent process chose to set up. (See also the "Redirections" section of 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. Cela signifie par exemple qu'après un exec(3), le processus enfant hérite de tous les descripteurs de fichier ouverts, mais que les tous les anciens 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.
NORMES¶
C11, POSIX.1-2008.
Les « standards » stipulent également que ces trois flux doivent être ouverts au démarrage du programme.
HISTORIQUE¶
C89, POSIX.1-2001.
NOTES¶
The stream stderr is unbuffered. The stream stdout is line-buffered when it points to a terminal. Partial lines will not appear until fflush(3) or exit(3) is called, or a newline is printed. This can produce unexpected results, especially with debugging output. The buffering mode of the standard streams (or any other stream) can be changed using the setbuf(3) or setvbuf(3) call. Note that in case stdin is associated with a terminal, there may also be input buffering in the terminal driver, entirely unrelated to stdio buffering. (Indeed, normally terminal input is line buffered in the kernel.) This kernel input handling can be modified using calls like tcsetattr(3); see also stty(1), and termios(7).
VOIR AUSSI¶
TRADUCTION¶
La traduction française de cette page de manuel a été créée par Christophe Blaess <https://www.blaess.fr/christophe/>, Stéphan Rafin <stephan.rafin@laposte.net>, Thierry Vignaud <tvignaud@mandriva.com>, François Micaux, Alain Portal <aportal@univ-montp2.fr>, Jean-Philippe Guérard <fevrier@tigreraye.org>, Jean-Luc Coulon (f5ibh) <jean-luc.coulon@wanadoo.fr>, Julien Cristau <jcristau@debian.org>, Thomas Huriaux <thomas.huriaux@gmail.com>, Nicolas François <nicolas.francois@centraliens.net>, Florentin Duneau <fduneau@gmail.com>, Simon Paillard <simon.paillard@resel.enst-bretagne.fr>, Denis Barbier <barbier@debian.org>, David Prévot <david@tilapin.org> et Frédéric Hantrais <fhantrais@gmail.com>
Cette traduction est une documentation libre ; veuillez vous reporter à la GNU General Public License version 3 concernant les conditions de copie et de distribution. Il n'y a aucune RESPONSABILITÉ LÉGALE.
Si vous découvrez un bogue dans la traduction de cette page de manuel, veuillez envoyer un message à debian-l10n-french@lists.debian.org.
| 2 juillet 2026 | Linux man-pages 6.20 |