Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

feof — funkcja strumieniowa C23

`feof(stream)` z `<stdio.h>` sprawdza wskaźnik końca pliku należący do otwartego strumienia `FILE`. Zwraca wartość niezerową wtedy i tylko wtedy, gdy wskaźnik jest ustawiony; nie czyta danych i nie zwraca samej stałej `EOF`.

Wersja: C23

Składnia

int feof(FILE *stream);

feof(stream) z <stdio.h> sprawdza wskaźnik końca pliku należący do otwartego strumienia FILE. Zwraca wartość niezerową wtedy i tylko wtedy, gdy wskaźnik jest ustawiony; nie czyta danych i nie zwraca samej stałej EOF.

Przykład zapisuje jeden znak do tmpfile(), przewija strumień, czyta znak i obserwuje feof == 0. Dopiero kolejna próba fgetc zwraca EOF i ustawia wskaźnik; wynik 0 1 0 0 pokazuje także brak błędu oraz wyczyszczenie stanu przez clearerr.

feof nie przewiduje końca pliku: pętla powinna najpierw sprawdzać wynik operacji wejścia, a dopiero potem używać feof i ferror do rozpoznania przyczyny. Dokładne odczytanie ostatniego bajtu jeszcze nie ustawia wskaźnika. stream musi być poprawnym otwartym strumieniem; clearerr, rewind i udane pozycjonowanie mogą wyczyścić stan EOF.

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);
    if (fgetc(stream) != 'A') { fclose(stream); return 1; }
    int before = feof(stream) != 0;
    if (fgetc(stream) != EOF) { fclose(stream); return 1; }
    int after = feof(stream) != 0;
    int failed = ferror(stream) != 0;
    clearerr(stream);
    printf("%d %d %d %d\n", before, after, failed, feof(stream) != 0);
    return fclose(stream) == 0 ? 0 : 1;
}

Wynik

0 1 0 0

Przykład zapisuje jeden znak do `tmpfile()`, przewija strumień, czyta znak i obserwuje `feof == 0`. Dopiero kolejna próba `fgetc` zwraca `EOF` i ustawia wskaźnik; wynik `0 1 0 0` pokazuje także brak błędu oraz wyczyszczenie stanu przez `clearerr`.

Źródła