CKTIS / C
ferror — função de fluxo C23
`ferror(stream)` de `<stdio.h>` testa o indicador de erro de um fluxo `FILE` aberto. Devolve valor não zero se e só se estiver definido; não executa E/S, não fornece um código de erro específico nem altera o estado do fluxo.
Versão: C23
Sintaxe
int ferror(FILE *stream);ferror(stream) de <stdio.h> testa o indicador de erro de um fluxo FILE aberto. Devolve valor não zero se e só se estiver definido; não executa E/S, não fornece um código de erro específico nem altera o estado do fluxo.
O exemplo lê para lá do único caráter de um tmpfile(). 1 0 0 mostra que fgetc devolveu EOF por fim de ficheiro, que ferror ficou a zero e que clearerr limpou ambos os indicadores.
O resultado EOF de uma função de entrada é ambíguo; só feof e ferror distinguem dados esgotados de falha de leitura. ferror não limpa o indicador nem dá a causa do sistema; preserva qualquer errno relevante e usa clearerr antes de repetir deliberadamente. stream tem de designar um fluxo aberto válido.
Exemplos
#include <stdio.h>
int main(void) {
FILE *stream = tmpfile();
if (stream == NULL) return 1;
if (fputc('A', stream) == EOF) { fclose(stream); return 1; }
rewind(stream);
(void)fgetc(stream);
int at_end = fgetc(stream) == EOF && feof(stream) != 0;
int failed = ferror(stream) != 0;
clearerr(stream);
printf("%d %d %d\n", at_end, failed, feof(stream) != 0 || ferror(stream) != 0);
return fclose(stream) == 0 ? 0 : 1;
}
Resultado
1 0 0
O exemplo lê para lá do único caráter de um `tmpfile()`. `1 0 0` mostra que `fgetc` devolveu `EOF` por fim de ficheiro, que `ferror` ficou a zero e que `clearerr` limpou ambos os indicadores.