CKTIS / C
clearerr — C23-Streamzustandsfunktion
`clearerr(stream)` aus `<stdio.h>` löscht sowohl die Dateiende- als auch die Fehleranzeige des angegebenen `FILE`-Streams und liefert keinen Wert. Die Funktion führt keine Ein- oder Ausgabe aus.
Version: C23
Syntax
void clearerr(FILE *stream);clearerr(stream) aus <stdio.h> löscht sowohl die Dateiende- als auch die Fehleranzeige des angegebenen FILE-Streams und liefert keinen Wert. Die Funktion führt keine Ein- oder Ausgabe aus.
Verwenden Sie sie, bevor nach Behandlung von EOF oder Fehler bewusst weiteres I/O versucht wird. Das Beispiel liest in einem tmpfile() über das eine gespeicherte Zeichen hinaus, beobachtet feof = 1 und ferror = 0, ruft clearerr auf und beobachtet danach 0 0.
clearerr verschiebt die Dateiposition nicht, verwirft keine gepufferten Daten und wiederholt keine fehlgeschlagene Operation; späteres I/O kann beide Anzeigen erneut setzen. stream muss auf ein lebendes gültiges FILE-Objekt zeigen, und bei der Diagnose sind feof und ferror zu unterscheiden.
Beispiele
#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;
}
Ergebnis
1 0 0 0
Verwenden Sie sie, bevor nach Behandlung von EOF oder Fehler bewusst weiteres I/O versucht wird. Das Beispiel liest in einem `tmpfile()` über das eine gespeicherte Zeichen hinaus, beobachtet `feof = 1` und `ferror = 0`, ruft `clearerr` auf und beobachtet danach `0 0`.