Scroll to navigation

fflush(3) Library Functions Manual fflush(3)

NOM

fflush - Vider les tampons d'un flux

BIBLIOTHÈQUE

Bibliothèque C standard (libc, -lc)

SYNOPSIS

#include <stdio.h>
int fflush(FILE *_Nullable flux);

DESCRIPTION

Pour les flux de sortie, fflush() force l'écriture de toutes les données se trouvant dans les tampons de l'espace utilisateur pour la sortie donnée ou met à jour le flux à l’aide de la fonction d'écriture sous-jacente.

Pour les flux d'entrée associés à des fichiers dans lesquels on peut se positionner (c'est le cas des fichiers sur disque, mais pas des pipes ou des terminaux), fflush() supprime du tampon toute donnée lue depuis le fichier sous-jacent qui n'a pas été traitée par l'application.

L'état d'ouverture du flux n'est pas affecté.

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

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

VALEUR RENVOYÉE

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

ERREURS

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

La fonction fflush() peut aussi échouer et définir errno avec n'importe quelle erreur spécifiée pour la routine write(2).

ATTRIBUTS

Pour une explication des termes utilisés dans cette section, consulter attributes(7).

Interface Attribut Valeur
fflush() Sécurité des threads MT-Safe

STANDARDS

C11, POSIX.1-2008.

HISTORIQUE

C89, POSIX.1-2001, POSIX.1-2008.

POSIX.1-2008 précise les conditions de vidage des flux en entrée, mais ce n'était pas le cas pour POSIX.1-2001.

NOTES

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

VOIR AUSSI

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

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>, Frédéric Hantrais <fhantrais@gmail.com> et Lucien Gentis <lucien.gentis@waika9.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 mai 2024 Pages du manuel de Linux (non publiées)