CKTIS / C
feof — C23-Datenstromfunktion
`feof(stream)` aus `<stdio.h>` prüft die Dateiendeanzeige eines offenen `FILE`-Datenstroms. Es liefert genau dann einen Wert ungleich null, wenn die Anzeige gesetzt ist; es liest nichts und liefert nicht selbst die Konstante `EOF`.
Version: C23
Syntax
int feof(FILE *stream);feof(stream) aus <stdio.h> prüft die Dateiendeanzeige eines offenen FILE-Datenstroms. Es liefert genau dann einen Wert ungleich null, wenn die Anzeige gesetzt ist; es liest nichts und liefert nicht selbst die Konstante EOF.
Das Beispiel schreibt ein Zeichen in eine tmpfile(), spult zurück, liest das Zeichen und beobachtet feof == 0. Erst das nächste fgetc liefert EOF und setzt die Anzeige; 0 1 0 0 zeigt außerdem keinen Fehler und das Löschen durch clearerr.
feof sagt das Dateiende nicht voraus: Eine Schleife prüft zuerst das Ergebnis der Eingabeoperation und diagnostiziert danach mit feof und ferror. Erfolgreiches Lesen des letzten Bytes setzt die Anzeige noch nicht. stream muss ein gültiger offener Datenstrom sein; clearerr, rewind und erfolgreiche Neupositionierung können den EOF-Zustand löschen.
Beispiele
#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;
}
Ergebnis
0 1 0 0
Das Beispiel schreibt ein Zeichen in eine `tmpfile()`, spult zurück, liest das Zeichen und beobachtet `feof == 0`. Erst das nächste `fgetc` liefert `EOF` und setzt die Anzeige; `0 1 0 0` zeigt außerdem keinen Fehler und das Löschen durch `clearerr`.