CKTIS / C
ferror — funkcija toka C23
`ferror(stream)` iz `<stdio.h>` preveri kazalnik napake odprtega toka `FILE`. Vrne neničelno vrednost natanko tedaj, ko je kazalnik nastavljen; ne izvaja I/O, ne poda določene kode napake in ne spremeni stanja toka.
Različica: C23
Sintaksa
int ferror(FILE *stream);ferror(stream) iz <stdio.h> preveri kazalnik napake odprtega toka FILE. Vrne neničelno vrednost natanko tedaj, ko je kazalnik nastavljen; ne izvaja I/O, ne poda določene kode napake in ne spremeni stanja toka.
Primer bere čez edini znak v tmpfile(). 1 0 0 pokaže, da je fgetc zaradi konca datoteke vrnil EOF, ferror je ostal nič in clearerr je počistil oba kazalnika.
Rezultat EOF vhodne funkcije je dvoumen; šele feof in ferror ločita izčrpane podatke od napake branja. ferror kazalnika ne počisti in ne poda sistemskega vzroka; shranite pomembni errno in pred zavestno ponovitvijo uporabite clearerr. stream mora označevati veljaven odprt tok.
Primeri
#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;
}
Rezultat
1 0 0
Primer bere čez edini znak v `tmpfile()`. `1 0 0` pokaže, da je `fgetc` zaradi konca datoteke vrnil `EOF`, `ferror` je ostal nič in `clearerr` je počistil oba kazalnika.