CKTIS / C
fflush — proudová funkce C23
`fflush(stream)` z `<stdio.h>` předá hostitelskému prostředí nezapsaná bufferovaná data výstupního nebo příslušného aktualizačního proudu. `fflush(NULL)` se o to pokusí pro všechny takové otevřené proudy; vrací nulu při úspěchu nebo `EOF` a nastaví příznak chyby při neúspěchu.
Verze: C23
Syntaxe
int fflush(FILE *stream);fflush(stream) z <stdio.h> předá hostitelskému prostředí nezapsaná bufferovaná data výstupního nebo příslušného aktualizačního proudu. fflush(NULL) se o to pokusí pro všechny takové otevřené proudy; vrací nulu při úspěchu nebo EOF a nastaví příznak chyby při neúspěchu.
Příklad zapíše hello do tmpfile(), zavolá fflush, přetočí proud a načte data pomocí fgets. 1 hello ukazuje úspěšné vyprázdnění a platný přechod od zápisu ke čtení aktualizačního proudu.
Standardní C nedefinuje fflush(stdin) jako odstranění vstupu: nesplňuje-li proud podmínku výstupu/aktualizace, je chování nedefinované. Úspěch znamená předání prostředí, nikoli nutně trvalý zápis na médium. Kontrolujte EOF; po chybě zůstane příznak nastaven do operace, která jej zruší, například clearerr nebo rewind.
Příklady
#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;
}
Výsledek
1 hello
Příklad zapíše `hello` do `tmpfile()`, zavolá `fflush`, přetočí proud a načte data pomocí `fgets`. `1 hello` ukazuje úspěšné vyprázdnění a platný přechod od zápisu ke čtení aktualizačního proudu.