WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

fflush — C23-Datenstromfunktion

`fflush(stream)` aus `<stdio.h>` übergibt bei einem Ausgabe- oder geeigneten Aktualisierungsstrom ungeschriebene gepufferte Daten an die Hostumgebung. `fflush(NULL)` versucht dies für alle solchen offenen Ströme; Ergebnis ist null bei Erfolg oder `EOF` mit gesetzter Fehleranzeige bei Fehlschlag.

Version: C23

Syntax

int fflush(FILE *stream);

fflush(stream) aus <stdio.h> übergibt bei einem Ausgabe- oder geeigneten Aktualisierungsstrom ungeschriebene gepufferte Daten an die Hostumgebung. fflush(NULL) versucht dies für alle solchen offenen Ströme; Ergebnis ist null bei Erfolg oder EOF mit gesetzter Fehleranzeige bei Fehlschlag.

Das Beispiel schreibt hello in eine tmpfile(), ruft fflush auf, spult zurück und liest mit fgets. 1 hello zeigt erfolgreiches Leeren und einen gültigen Wechsel vom Schreiben zum Lesen eines Aktualisierungsstroms.

Standard-C definiert fflush(stdin) nicht zum Verwerfen von Eingabe: Erfüllt der angegebene Strom die Ausgabe-/Aktualisierungsbedingung nicht, ist das Verhalten undefiniert. Erfolg bedeutet Übergabe an die Hostumgebung, nicht zwingend dauerhafte Speicherung. Auf EOF prüfen; nach einem Fehler bleibt die Anzeige bis zu einer löschenden Operation wie clearerr oder rewind gesetzt.

Beispiele

#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;
}

Ergebnis

1 hello

Das Beispiel schreibt `hello` in eine `tmpfile()`, ruft `fflush` auf, spult zurück und liest mit `fgets`. `1 hello` zeigt erfolgreiches Leeren und einen gültigen Wechsel vom Schreiben zum Lesen eines Aktualisierungsstroms.

Quellen