Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes