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`.