clearerr

Artikel
06/09/2015

Setzt den Fehler für einen Stream zurück. Eine sicherere Version dieser Funktion ist verfügbar; finden Sie unter clearerr_s.

void clearerr(
   FILE *stream 
);

Parameter

stream
Zeiger zur FILE-Struktur.

Hinweise

Die clearerr-Funktion setzt den Fehler und den Dateiende-Indikator für stream zurück. Fehlerindikatoren werden nicht automatisch gelöscht; einmal wird der Fehler für den jeweiligen Stream festgelegt, fahren Vorgänge auf diesem Stream fort, um einem Fehlerwert bis clearerr, fseek, fsetpos zurückzugeben, oder rewind wird aufgerufen.

Wenn stream den Wert NULL annimmt, wird der ungültige Parameterhandler, wie in Parametervalidierung beschrieben, aufgerufen. Wenn die Ausführung zulässig ist, um fortzufahren, Sätze errno dieser Funktion in EINVAL und gibt an. Weitere Informationen über errno und Fehlercodes, finden Sie unter errno Konstanten.

Eine sicherere Version dieser Funktion ist verfügbar; finden Sie unter clearerr_s.

Anforderungen

Routine	Erforderlicher Header
clearerr	<stdio.h>

Zusätzliche Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.

Beispiel

// crt_clearerr.c
// This program creates an error
// on the standard input stream, then clears
// it so that future reads won't fail.

#include <stdio.h>

int main( void )
{
   int c;
   // Create an error by writing to standard input.
   putc( 'c', stdin );
   if( ferror( stdin ) )
   {
      perror( "Write error" );
      clearerr( stdin );
   }

   // See if read causes an error.
   printf( "Will input cause an error? " );
   c = getc( stdin );
   if( ferror( stdin ) )
   {
      perror( "Read error" );
      clearerr( stdin );
   }
   else
      printf( "No read error\n" );
}