CKTIS / C
ferror — funkcija toka C23
`ferror(stream)` iz `<stdio.h>` ispituje pokazatelj pogreške otvorenog toka `FILE`. Vraća nenultu vrijednost ako i samo ako je pokazatelj postavljen; ne izvodi I/O, ne daje određeni kod pogreške i ne mijenja stanje toka.
Verzija: C23
Sintaksa
int ferror(FILE *stream);ferror(stream) iz <stdio.h> ispituje pokazatelj pogreške otvorenog toka FILE. Vraća nenultu vrijednost ako i samo ako je pokazatelj postavljen; ne izvodi I/O, ne daje određeni kod pogreške i ne mijenja stanje toka.
Primjer čita iza jedinog znaka u tmpfile(). 1 0 0 pokazuje da je fgetc vratio EOF zbog kraja datoteke, ferror je ostao nula i clearerr je obrisao oba pokazatelja.
Rezultat EOF ulazne funkcije dvosmislen je; tek feof i ferror razlikuju iscrpljene podatke od pogreške čitanja. ferror ne briše pokazatelj niti daje sistemski uzrok; sačuvaj važni errno i prije svjesnog ponavljanja koristi clearerr. stream mora označavati valjan otvoren tok.
Primjeri
#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
Primjer čita iza jedinog znaka u `tmpfile()`. `1 0 0` pokazuje da je `fgetc` vratio `EOF` zbog kraja datoteke, `ferror` je ostao nula i `clearerr` je obrisao oba pokazatelja.