CKTIS / C
clearerr — funkcija stanja toka C23
`clearerr(stream)` iz `<stdio.h>` počisti kazalnik konca datoteke in kazalnik napake podanega toka `FILE`; ne vrne vrednosti. Ne izvede nobene vhodne ali izhodne operacije.
Različica: C23
Sintaksa
void clearerr(FILE *stream);clearerr(stream) iz <stdio.h> počisti kazalnik konca datoteke in kazalnik napake podanega toka FILE; ne vrne vrednosti. Ne izvede nobene vhodne ali izhodne operacije.
Uporabite jo pred zavestnim poskusom nadaljnjega I/O po obravnavi EOF ali napake. Primer bere čez edini znak v tmpfile(), opazi feof = 1 in ferror = 0, pokliče clearerr ter nato opazi 0 0.
clearerr ne premakne položaja, ne zavrže podatkov v medpomnilniku in ne ponovi neuspele operacije; poznejši I/O lahko kazalnika znova nastavi. stream mora kazati na živ veljaven objekt FILE, diagnostika pa mora ločiti feof od ferror.
Primeri
#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;
}
Rezultat
1 0 0 0
Uporabite jo pred zavestnim poskusom nadaljnjega I/O po obravnavi EOF ali napake. Primer bere čez edini znak v `tmpfile()`, opazi `feof = 1` in `ferror = 0`, pokliče `clearerr` ter nato opazi `0 0`.