Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / C

ferror — proudová funkce C23

`ferror(stream)` z `<stdio.h>` testuje příznak chyby otevřeného proudu `FILE`. Vrací nenulovou hodnotu právě tehdy, když je příznak nastaven; neprovádí I/O, neposkytuje konkrétní chybový kód a nemění stav proudu.

Verze: C23

Syntaxe

int ferror(FILE *stream);

ferror(stream) z <stdio.h> testuje příznak chyby otevřeného proudu FILE. Vrací nenulovou hodnotu právě tehdy, když je příznak nastaven; neprovádí I/O, neposkytuje konkrétní chybový kód a nemění stav proudu.

Příklad čte za jediný znak v tmpfile(). 1 0 0 ukazuje, že fgetc vrátilo EOF kvůli konci souboru, ferror zůstalo nulové a clearerr zrušilo oba příznaky.

Výsledek EOF vstupní funkce je nejednoznačný; až feof a ferror odliší vyčerpaná data od chyby čtení. ferror příznak nemaže ani neudává systémovou příčinu; uchovejte potřebné errno a před vědomým opakováním použijte clearerr. stream musí označovat platný otevřený proud.

Příklady

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

Výsledek

1 0 0

Příklad čte za jediný znak v `tmpfile()`. `1 0 0` ukazuje, že `fgetc` vrátilo `EOF` kvůli konci souboru, `ferror` zůstalo nulové a `clearerr` zrušilo oba příznaky.

Zdroje