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`.