CKTIS / C
clearerr — C23-streamstatusfunctie
`clearerr(stream)` uit `<stdio.h>` wist zowel de einde-bestandindicator als de foutindicator van de opgegeven `FILE`-stream en retourneert niets. De functie voert geen invoer of uitvoer uit.
Versie: C23
Syntax
void clearerr(FILE *stream);clearerr(stream) uit <stdio.h> wist zowel de einde-bestandindicator als de foutindicator van de opgegeven FILE-stream en retourneert niets. De functie voert geen invoer of uitvoer uit.
Gebruik dit voordat na afhandeling van EOF of een fout bewust meer I/O wordt geprobeerd. Het voorbeeld leest voorbij het ene teken in een tmpfile(), ziet feof = 1 en ferror = 0, roept clearerr aan en ziet daarna 0 0.
clearerr verplaatst de bestandspositie niet, gooit geen gebufferde data weg en herhaalt de mislukte bewerking niet; latere I/O kan de indicatoren opnieuw zetten. stream moet naar een levend geldig FILE-object wijzen en diagnose moet feof van ferror onderscheiden.
Voorbeelden
#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;
}
Resultaat
1 0 0 0
Gebruik dit voordat na afhandeling van EOF of een fout bewust meer I/O wordt geprobeerd. Het voorbeeld leest voorbij het ene teken in een `tmpfile()`, ziet `feof = 1` en `ferror = 0`, roept `clearerr` aan en ziet daarna `0 0`.