Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / C

ferror — funzione di flusso C23

`ferror(stream)` di `<stdio.h>` controlla l’indicatore di errore di uno stream `FILE` aperto. Restituisce un valore diverso da zero se e solo se è impostato; non esegue I/O, non fornisce un codice specifico e non modifica lo stato dello stream.

Versione: C23

Sintassi

int ferror(FILE *stream);

ferror(stream) di <stdio.h> controlla l’indicatore di errore di uno stream FILE aperto. Restituisce un valore diverso da zero se e solo se è impostato; non esegue I/O, non fornisce un codice specifico e non modifica lo stato dello stream.

L’esempio legge oltre l’unico carattere di un tmpfile(). 1 0 0 mostra che fgetc ha restituito EOF per fine file, che ferror è rimasto zero e che clearerr ha cancellato entrambi gli indicatori.

Il risultato EOF di una funzione di input è ambiguo; solo feof e ferror distinguono dati esauriti e errore di lettura. ferror non cancella l’indicatore né dà la causa di sistema; conserva l’eventuale errno e usa clearerr prima di un nuovo tentativo consapevole. stream deve indicare uno stream aperto valido.

Esempi

#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;
}

Risultato

1 0 0

L’esempio legge oltre l’unico carattere di un `tmpfile()`. `1 0 0` mostra che `fgetc` ha restituito `EOF` per fine file, che `ferror` è rimasto zero e che `clearerr` ha cancellato entrambi gli indicatori.

Fonti