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

CKTIS / C

clearerr — função de estado de fluxo C23

`clearerr(stream)` de `<stdio.h>` limpa tanto o indicador de fim de ficheiro como o indicador de erro do fluxo `FILE` indicado; não devolve valor. Não executa qualquer operação de entrada ou saída.

Versão: C23

Sintaxe

void clearerr(FILE *stream);

clearerr(stream) de <stdio.h> limpa tanto o indicador de fim de ficheiro como o indicador de erro do fluxo FILE indicado; não devolve valor. Não executa qualquer operação de entrada ou saída.

Usa-a antes de tentar deliberadamente mais E/S depois de tratar EOF ou erro. O exemplo lê para lá do único caráter de um tmpfile(), observa feof = 1 e ferror = 0, chama clearerr e depois observa 0 0.

clearerr não move a posição, não descarta dados em buffer nem repete a operação falhada; E/S posterior pode voltar a definir os indicadores. stream tem de apontar para um objeto FILE válido e vivo, e o diagnóstico deve distinguir feof de ferror.

Exemplos

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    fputs("A", stream);
    rewind(stream);
    (void)fgetc(stream);
    (void)fgetc(stream);
    printf("%d %d ", feof(stream) != 0, ferror(stream) != 0);
    clearerr(stream);
    printf("%d %d\n", feof(stream) != 0, ferror(stream) != 0);
    fclose(stream);
    return 0;
}

Resultado

1 0 0 0

Usa-a antes de tentar deliberadamente mais E/S depois de tratar EOF ou erro. O exemplo lê para lá do único caráter de um `tmpfile()`, observa `feof = 1` e `ferror = 0`, chama `clearerr` e depois observa `0 0`.

Fontes