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

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.

Fontes