WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / C

ferror — C23-Datenstromfunktion

`ferror(stream)` aus `<stdio.h>` prüft die Fehleranzeige eines offenen `FILE`-Datenstroms. Es liefert genau dann einen Wert ungleich null, wenn die Anzeige gesetzt ist; es führt kein I/O aus, liefert keinen konkreten Fehlercode und ändert den Datenstromzustand nicht.

Version: C23

Syntax

int ferror(FILE *stream);

ferror(stream) aus <stdio.h> prüft die Fehleranzeige eines offenen FILE-Datenstroms. Es liefert genau dann einen Wert ungleich null, wenn die Anzeige gesetzt ist; es führt kein I/O aus, liefert keinen konkreten Fehlercode und ändert den Datenstromzustand nicht.

Das Beispiel liest hinter dem einzigen Zeichen einer tmpfile(). 1 0 0 zeigt, dass fgetc wegen Dateiende EOF lieferte, ferror null blieb und nach clearerr beide Anzeigen gelöscht sind.

Das EOF-Ergebnis einer Eingabefunktion ist mehrdeutig; erst feof und ferror unterscheiden Datenende und Lesefehler. ferror löscht die Anzeige nicht und nennt keine Betriebssystemursache; relevantes errno sichern und vor bewusstem Wiederholen clearerr verwenden. stream muss einen gültigen offenen Datenstrom bezeichnen.

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);
    (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;
}

Ergebnis

1 0 0

Das Beispiel liest hinter dem einzigen Zeichen einer `tmpfile()`. `1 0 0` zeigt, dass `fgetc` wegen Dateiende `EOF` lieferte, `ferror` null blieb und nach `clearerr` beide Anzeigen gelöscht sind.

Quellen