Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / C

clearerr — funkcja stanu strumienia C23

`clearerr(stream)` z `<stdio.h>` usuwa wskaźnik końca pliku i wskaźnik błędu należące do wskazanego strumienia `FILE`; funkcja niczego nie zwraca. Nie wykonuje operacji wejścia/wyjścia.

Wersja: C23

Składnia

void clearerr(FILE *stream);

clearerr(stream) z <stdio.h> usuwa wskaźnik końca pliku i wskaźnik błędu należące do wskazanego strumienia FILE; funkcja niczego nie zwraca. Nie wykonuje operacji wejścia/wyjścia.

Używaj jej przed świadomą próbą dalszego I/O po obsłużeniu EOF albo błędu. Przykład czyta z tmpfile() poza zapisany znak, obserwuje feof = 1 i ferror = 0, wywołuje clearerr, a następnie obserwuje 0 0.

clearerr nie zmienia pozycji pliku, nie odrzuca buforowanych danych i nie powtarza nieudanej operacji; późniejsze I/O może ponownie ustawić oba wskaźniki. stream musi wskazywać żywy, poprawny obiekt FILE, a przy diagnozie trzeba odróżniać feof od ferror.

Przykłady

#include <stdio.h>

int main(void) {
    FILE *stream = tmpfile();
    if (stream == NULL) return 1;
    fputs("A", stream);
    rewind(stream);
    (void)fgetc(stream);
    (void)fgetc(stream);
    printf("%d %d ", feof(stream) != 0, ferror(stream) != 0);
    clearerr(stream);
    printf("%d %d\n", feof(stream) != 0, ferror(stream) != 0);
    fclose(stream);
    return 0;
}

Wynik

1 0 0 0

Używaj jej przed świadomą próbą dalszego I/O po obsłużeniu EOF albo błędu. Przykład czyta z `tmpfile()` poza zapisany znak, obserwuje `feof = 1` i `ferror = 0`, wywołuje `clearerr`, a następnie obserwuje `0 0`.

Źródła