KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / C

ferror — C23-streamfunctie

`ferror(stream)` uit `<stdio.h>` test de foutindicator van een open `FILE`-stream. De functie retourneert uitsluitend niet-nul wanneer de indicator is gezet; ze voert geen I/O uit, geeft geen specifieke foutcode en wijzigt de streamtoestand niet.

Versie: C23

Syntax

int ferror(FILE *stream);

ferror(stream) uit <stdio.h> test de foutindicator van een open FILE-stream. De functie retourneert uitsluitend niet-nul wanneer de indicator is gezet; ze voert geen I/O uit, geeft geen specifieke foutcode en wijzigt de streamtoestand niet.

Het voorbeeld leest voorbij het enige teken in een tmpfile(). 1 0 0 toont dat fgetc wegens bestandseinde EOF retourneerde, ferror nul bleef en clearerr beide indicatoren wiste.

Het EOF-resultaat van een invoerfunctie is dubbelzinnig; alleen feof en ferror onderscheiden uitgeputte invoer en leesfout. ferror wist de indicator niet en geeft geen systeemoorzaak; bewaar relevant errno en gebruik clearerr vóór een bewuste nieuwe poging. stream moet een geldige open stream aanduiden.

Voorbeelden

#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;
}

Resultaat

1 0 0

Het voorbeeld leest voorbij het enige teken in een `tmpfile()`. `1 0 0` toont dat `fgetc` wegens bestandseinde `EOF` retourneerde, `ferror` nul bleef en `clearerr` beide indicatoren wiste.

Bronnen