Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

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.

Źródła