fflush

Autres langues

Langue: fr

Version: 21 juillet 2003 (openSuse - 09/10/07)

Section: 3 (Bibliothèques de fonctions)

NOM

fflush - Vider les buffers d'un flux.

SYNOPSIS

#include <stdio.h>

int fflush (FILE *flux);

DESCRIPTION

La fonction fflush force l'écriture de toutes les données se trouvant dans les buffers de l'espace utilisateur, et met à jour le flux à travers la fonction sous-jacente d'écriture. Le statut d'ouverture du flux n'est pas affecté.

Si l'argument flux est NULL, fflush vide tous les flux en sortie.

Pour une version de cette fonction ignorant les verrouillages, voir unlocked_stdio(3).

VALEUR RENVOYÉE

Si elle réussit intégralement, cette fonctions renvoie 0. Sinon, elle renvoie EOF, et la variable errno contient le code d'erreur.

ERREURS

EBADF
flux n'est pas ouvert, ou du moins pas en écriture.

La fonction fflush peut aussi échouer, et positionner dans errno n'importe quelles erreurs spécifiées dans la routine write(2).

NOTES

Remarquez que fflush() ne vide que les buffers fournis par la bibliothèque C dans l'espace utilisateur. Pour s'assurer que les données sont écrites physiquement sur le disque, il faut vider les buffers du noyau à l'aide par exemple de sync(2) ou fsync(2).

CONFORMITÉ

La fonction fflush() est conforme à ANSI X3.159-1989 (``ANSI C'').

VOIR AUSSI

fsync(2), sync(2), write(2), fclose(3), fopen(3), setbuf(3), unlocked_stdio(3)

TRADUCTION

Christophe Blaess, 1996-2003.