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.