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.