clearerr_s

Artikel
06/09/2015

Setzt den Fehler für einen Stream zurück. Dies ist eine Version von clearerr mit werden, wie in Sicherheitsfunktionen in der CRT beschrieben.

errno_t clearerr_s(
   FILE *stream 
);

Parameter

stream
Zeiger FILE-Struktur

Rückgabewert

Null wenn erfolgreich; EINVAL, wenn stream NULL ist.

Hinweise

Die clearerr_s-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_s, clearerr, fseek, fsetpos zurückzugeben, oder rewind wird aufgerufen.

Wenn stream NULL ist, wird der ungültige Parameterhandler wie in Parametervalidierung beschrieben aufgerufen. Wenn die weitere Ausführung zugelassen wird, legt diese Funktion errno auf EINVAL fest und gibt EINVAL zurück.

Anforderungen

Routine	Erforderlicher Header
clearerr_s	<stdio.h>

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

Beispiel

// crt_clearerr_s.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;
   errno_t err;

   // Create an error by writing to standard input.
   putc( 'c', stdin );
   if( ferror( stdin ) )
   {
      perror( "Write error" );
      err = clearerr_s( stdin );
      if (err != 0)
      {
         abort();
      }
   }

   // See if read causes an error.
   printf( "Will input cause an error? " );
   c = getc( stdin );
   if( ferror( stdin ) )
   {
      perror( "Read error" );
      err = clearerr_s( stdin );
      if (err != 0)
      {
         abort();
      }
   }
}