Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

fflush — funkcja strumieniowa C23

`fflush(stream)` z `<stdio.h>` dla strumienia wyjściowego lub odpowiedniego strumienia aktualizującego przekazuje niezapisane dane buforowane do środowiska hosta. `fflush(NULL)` próbuje opróżnić wszystkie takie otwarte strumienie; wynik to zero przy powodzeniu albo `EOF` z ustawieniem wskaźnika błędu przy niepowodzeniu.

Wersja: C23

Składnia

int fflush(FILE *stream);

fflush(stream) z <stdio.h> dla strumienia wyjściowego lub odpowiedniego strumienia aktualizującego przekazuje niezapisane dane buforowane do środowiska hosta. fflush(NULL) próbuje opróżnić wszystkie takie otwarte strumienie; wynik to zero przy powodzeniu albo EOF z ustawieniem wskaźnika błędu przy niepowodzeniu.

Przykład zapisuje hello do tmpfile(), wywołuje fflush, przewija strumień i odczytuje dane przez fgets. Wynik 1 hello pokazuje udane opróżnienie i poprawne przejście od zapisu do odczytu w strumieniu aktualizującym.

Standard C nie definiuje fflush(stdin) jako sposobu usuwania wejścia: gdy wskazany strumień nie spełnia warunków dla wyjścia/aktualizacji, zachowanie jest niezdefiniowane. Sukces oznacza przekazanie danych środowisku, niekoniecznie trwały zapis na nośniku. Sprawdzaj EOF; po błędzie wskaźnik pozostaje ustawiony do operacji czyszczącej, takiej jak clearerr lub rewind.

Przykłady

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

Wynik

1 hello

Przykład zapisuje `hello` do `tmpfile()`, wywołuje `fflush`, przewija strumień i odczytuje dane przez `fgets`. Wynik `1 hello` pokazuje udane opróżnienie i poprawne przejście od zapisu do odczytu w strumieniu aktualizującym.

Źródła