Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / C

fflush — fonction de flux C23

`fflush(stream)` de `<stdio.h>` remet à l’environnement hôte les données de sortie tamponnées non écrites d’un flux de sortie ou de mise à jour admissible. `fflush(NULL)` tente l’opération pour tous ces flux ouverts ; elle renvoie zéro en cas de succès ou `EOF` avec indicateur d’erreur en cas d’échec.

Version : C23

Syntaxe

int fflush(FILE *stream);

fflush(stream) de <stdio.h> remet à l’environnement hôte les données de sortie tamponnées non écrites d’un flux de sortie ou de mise à jour admissible. fflush(NULL) tente l’opération pour tous ces flux ouverts ; elle renvoie zéro en cas de succès ou EOF avec indicateur d’erreur en cas d’échec.

L’exemple écrit hello dans un tmpfile(), appelle fflush, rembobine puis lit avec fgets. 1 hello montre un vidage réussi et une transition valide de l’écriture à la lecture sur un flux de mise à jour.

Le C standard ne définit pas fflush(stdin) pour supprimer l’entrée : si le flux ne satisfait pas la condition de sortie/mise à jour, le comportement est indéfini. Le succès signifie remise à l’environnement, pas forcément persistance physique. Testez EOF ; après échec, l’indicateur reste posé jusqu’à une opération qui l’efface, telle que clearerr ou rewind.

Exemples

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    if (fputs("hello", stream) == EOF) { fclose(stream); return 1; }
    int flushed = fflush(stream) == 0;
    rewind(stream);
    char buffer[6];
    if (fgets(buffer, sizeof buffer, stream) == NULL) { fclose(stream); return 1; }
    printf("%d %s\n", flushed, buffer);
    return fclose(stream) == 0 ? 0 : 1;
}

Résultat

1 hello

L’exemple écrit `hello` dans un `tmpfile()`, appelle `fflush`, rembobine puis lit avec `fgets`. `1 hello` montre un vidage réussi et une transition valide de l’écriture à la lecture sur un flux de mise à jour.

Sources