CKTIS / C
clearerr — funkcija stanja toka C23
`clearerr(stream)` iz `<stdio.h>` briše pokazatelj kraja datoteke i pokazatelj pogreške zadanog toka `FILE`; ne vraća vrijednost. Ne izvodi ulaznu ni izlaznu operaciju.
Verzija: C23
Sintaksa
void clearerr(FILE *stream);clearerr(stream) iz <stdio.h> briše pokazatelj kraja datoteke i pokazatelj pogreške zadanog toka FILE; ne vraća vrijednost. Ne izvodi ulaznu ni izlaznu operaciju.
Koristi je prije svjesnog pokušaja daljnjeg I/O-a nakon obrade EOF-a ili pogreške. Primjer čita iza jedinog znaka u tmpfile(), opaža feof = 1 i ferror = 0, poziva clearerr te zatim opaža 0 0.
clearerr ne pomiče položaj, ne odbacuje podatke u međuspremniku i ne ponavlja neuspjelu operaciju; kasniji I/O može opet postaviti pokazatelje. stream mora pokazivati na živ valjan objekt FILE, a dijagnostika mora razlikovati feof od ferror.
Primjeri
#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
Koristi je prije svjesnog pokušaja daljnjeg I/O-a nakon obrade EOF-a ili pogreške. Primjer čita iza jedinog znaka u `tmpfile()`, opaža `feof = 1` i `ferror = 0`, poziva `clearerr` te zatim opaža `0 0`.