CKTIS / C
ferror — funkcja strumieniowa C23
`ferror(stream)` z `<stdio.h>` sprawdza wskaźnik błędu należący do otwartego strumienia `FILE`. Zwraca wartość niezerową wtedy i tylko wtedy, gdy wskaźnik jest ustawiony; nie wykonuje I/O, nie zwraca kodu konkretnego błędu i nie zmienia stanu strumienia.
Wersja: C23
Składnia
int ferror(FILE *stream);ferror(stream) z <stdio.h> sprawdza wskaźnik błędu należący do otwartego strumienia FILE. Zwraca wartość niezerową wtedy i tylko wtedy, gdy wskaźnik jest ustawiony; nie wykonuje I/O, nie zwraca kodu konkretnego błędu i nie zmienia stanu strumienia.
Przykład czyta z tmpfile() poza jedyny zapisany znak. Wynik 1 0 0 pokazuje, że fgetc zwrócił EOF z powodu końca pliku, ferror pozostał zerowy, a po clearerr oba wskaźniki są wyczyszczone.
Wartość EOF z funkcji wejścia jest niejednoznaczna, dlatego dopiero feof i ferror rozróżniają koniec danych od błędu odczytu. ferror nie czyści wskaźnika i nie podaje przyczyny systemowej; po zapisaniu potrzebnego errno użyj clearerr, jeśli świadomie ponawiasz I/O. stream musi być poprawnym otwartym strumieniem.
Przykłady
#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;
}
Wynik
1 0 0
Przykład czyta z `tmpfile()` poza jedyny zapisany znak. Wynik `1 0 0` pokazuje, że `fgetc` zwrócił `EOF` z powodu końca pliku, `ferror` pozostał zerowy, a po `clearerr` oba wskaźniki są wyczyszczone.