CKTIS / C
ferror — prúdová funkcia C23
`ferror(stream)` z `<stdio.h>` testuje príznak chyby otvoreného prúdu `FILE`. Vracia nenulovú hodnotu práve vtedy, keď je príznak nastavený; nevykonáva I/O, neposkytuje konkrétny chybový kód a nemení stav prúdu.
Verzia: C23
Syntax
int ferror(FILE *stream);ferror(stream) z <stdio.h> testuje príznak chyby otvoreného prúdu FILE. Vracia nenulovú hodnotu práve vtedy, keď je príznak nastavený; nevykonáva I/O, neposkytuje konkrétny chybový kód a nemení stav prúdu.
Príklad číta za jediný znak v tmpfile(). 1 0 0 ukazuje, že fgetc vrátilo EOF pre koniec súboru, ferror zostalo nulové a clearerr zrušilo oba príznaky.
Výsledok EOF vstupnej funkcie je nejednoznačný; až feof a ferror odlíšia vyčerpané dáta od chyby čítania. ferror príznak nemaže ani neudáva systémovú príčinu; uchovajte potrebné errno a pred vedomým opakovaním použite clearerr. stream musí označovať platný otvorený prúd.
Príklady
#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;
}
Výsledok
1 0 0
Príklad číta za jediný znak v `tmpfile()`. `1 0 0` ukazuje, že `fgetc` vrátilo `EOF` pre koniec súboru, `ferror` zostalo nulové a `clearerr` zrušilo oba príznaky.