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`.