fflushfflush

Vide un flux.Flushes a stream.

SyntaxeSyntax

int fflush(
   FILE *stream
);

ParamètresParameters

streamstream
Pointeur désignant la structure FILE.Pointer to FILE structure.

Valeur de retourReturn Value

fflush retourne 0 si la mémoire tampon a été vidée avec succès.fflush returns 0 if the buffer was successfully flushed. La valeur 0 est également retournée si le flux spécifié n’a aucune mémoire tampon ou est ouvert en lecture seule.The value 0 is also returned in cases in which the specified stream has no buffer or is open for reading only. Une valeur de retour de EOF indique une erreur.A return value of EOF indicates an error.

Notes

Si fflush retourne EOF, les données ont peut-être été perdues en raison d’un échec d’écriture.If fflush returns EOF, data may have been lost due to a write failure. Lors de la configuration d’un gestionnaire d’erreurs critique, il est plus sûr de désactiver la mise en mémoire tampon avec la fonction setvbuf ou d’utiliser des routines d’e/s de bas niveau telles que _open, Fermeret _ Write au lieu des fonctions d’e/s de flux.When setting up a critical error handler, it is safest to turn buffering off with the setvbuf function or to use low-level I/O routines such as _open, _close, and _write instead of the stream I/O functions.

NotesRemarks

La fonction fflush vide le fluxde flux.The fflush function flushes the stream stream. Si le flux a été ouvert en mode d’écriture ou qu’il a été ouvert en mode de mise à jour et que la dernière opération était une écriture, le contenu de la mémoire tampon du flux est écrit dans le fichier ou périphérique sous-jacent et la mémoire tampon est abandonnée.If the stream was opened in write mode, or it was opened in update mode and the last operation was a write, the contents of the stream buffer are written to the underlying file or device and the buffer is discarded. Si le flux a été ouvert en mode lecture, ou si le flux n’a pas de mémoire tampon, l’appel à fflush n’a aucun effet, et toute mémoire tampon est conservée.If the stream was opened in read mode, or if the stream has no buffer, the call to fflush has no effect, and any buffer is retained. Un appel à fflush inverse l’effet de tout appel antérieur à ungetc pour le flux.A call to fflush negates the effect of any prior call to ungetc for the stream. Le flux reste ouvert après l’appel.The stream remains open after the call.

Si Stream a la valeur null, le comportement est le même qu’un appel à fflush sur chaque flux ouvert.If stream is NULL, the behavior is the same as a call to fflush on each open stream. Tous les flux ouverts en mode d’écriture et tous les flux ouverts en mode de mise à jour où la dernière opération était une écriture sont vidés.All streams opened in write mode and all streams opened in update mode where the last operation was a write are flushed. L’appel n’a aucun effet sur les autres flux.The call has no effect on other streams.

Les mémoires tampons sont normalement gérées par le système d’exploitation, qui détermine à quel moment les données doivent être automatiquement écrites sur le disque : quand une mémoire tampon est saturée, quand un flux est fermé ou quand un programme se termine normalement sans fermer le flux.Buffers are normally maintained by the operating system, which determines the optimal time to write the data automatically to disk: when a buffer is full, when a stream is closed, or when a program terminates normally without closing the stream. La fonctionnalité de validation sur disque de la bibliothèque runtime garantit que les données critiques sont écrites directement sur le disque plutôt que dans les mémoires tampons du système d’exploitation.The commit-to-disk feature of the run-time library lets you ensure that critical data is written directly to disk rather than to the operating-system buffers. Sans réécrire un programme existant, vous pouvez activer cette fonctionnalité en liant les fichiers objets du programme avec COMMODE.OBJ.Without rewriting an existing program, you can enable this feature by linking the program's object files with COMMODE.OBJ. Dans le fichier exécutable résultant, les appels à _flushall écrivent le contenu de toutes les mémoires tampons sur le disque.In the resulting executable file, calls to _flushall write the contents of all buffers to disk. Seuls _flushall et fflush sont affectés par le mode. obj de commode.Only _flushall and fflush are affected by COMMODE.OBJ.

Pour plus d’informations sur le contrôle de la fonctionnalité de validation sur disque, consultez E/S de flux, fopen et _fdopen.For information about controlling the commit-to-disk feature, see Stream I/O, fopen, and _fdopen.

Cette fonction verrouille le thread appelant et est donc thread-safe.This function locks the calling thread and is therefore thread-safe. Pour une version sans verrouillage, consultez _fflush_nolock.For a non-locking version, see _fflush_nolock.

Configuration requiseRequirements

FonctionFunction En-tête requisRequired header
fflushfflush <stdio.h><stdio.h>

Pour plus d’informations sur la compatibilité, voir consultez Compatibilité.For additional compatibility information, see Compatibility.

ExempleExample

// crt_fflush.c
// Compile with: cl /W4 crt_fflush.c
// This sample gets a number from the user, then writes it to a file.
// It ensures the write isn't lost on crash by calling fflush.
#include <stdio.h>

int * crash_the_program = 0;

int main(void)
{
    FILE * my_file;
    errno_t err = fopen_s(&my_file, "myfile.txt", "w");
    if (my_file && !err)
    {
        printf("Write a number: ");

        int my_number = 0;
        scanf_s("%d", &my_number);

        fprintf(my_file, "User selected %d\n", my_number);

        // Write data to a file immediately instead of buffering.
        fflush(my_file);
    
        if (my_number == 5)
        {
            // Without using fflush, no data was written to the file 
            // prior to the crash, so the data is lost.
            *crash_the_program = 5;
        }

        // Normally, fflush is not needed as closing the file will write the buffer.
        // Note that files are automatically closed and flushed during normal termination.
        fclose(my_file);
    }
    return 0;
}
5
User selected 5

Voir aussiSee also

E/S de fluxStream I/O
fclose, _fcloseallfclose, _fcloseall
_flushall_flushall
setvbufsetvbuf