CKTIS / C
fflush — função de fluxo C23
`fflush(stream)` de `<stdio.h>` entrega ao ambiente anfitrião os dados de saída em buffer ainda não escritos de um fluxo de saída ou atualização admissível. `fflush(NULL)` tenta fazê-lo para todos esses fluxos abertos; devolve zero no sucesso ou `EOF` com indicador de erro na falha.
Versão: C23
Sintaxe
int fflush(FILE *stream);fflush(stream) de <stdio.h> entrega ao ambiente anfitrião os dados de saída em buffer ainda não escritos de um fluxo de saída ou atualização admissível. fflush(NULL) tenta fazê-lo para todos esses fluxos abertos; devolve zero no sucesso ou EOF com indicador de erro na falha.
O exemplo escreve hello num tmpfile(), chama fflush, rebobina e lê através de fgets. 1 hello mostra uma descarga bem-sucedida e uma transição válida de escrita para leitura num fluxo de atualização.
C padrão não define fflush(stdin) para descartar entrada: se o fluxo não cumprir a condição de saída/atualização, o comportamento é indefinido. Sucesso significa entrega ao ambiente, não necessariamente persistência no suporte físico. Verifica EOF; após falha, o indicador fica definido até uma operação que o limpe, como clearerr ou rewind.
Exemplos
#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;
}
Resultado
1 hello
O exemplo escreve `hello` num `tmpfile()`, chama `fflush`, rebobina e lê através de `fgets`. `1 hello` mostra uma descarga bem-sucedida e uma transição válida de escrita para leitura num fluxo de atualização.