clearerr

發行項
06/09/2015

重設資料流的錯誤指示器。這些函式已有更安全的版本可用，請參閱 clearerr_s。

void clearerr(
   FILE *stream 
);

參數

stream
指向 FILE 結構的指標。

備註

clearerr 函式會將錯誤指示器和檔案結尾標記的 stream。不會自動清除錯誤指示器;一次指定的資料流的錯誤指示器設定，該資料流的作業繼續之前傳回錯誤值，直到呼叫clearerr， fseek， fsetpos， rewind。

如果 stream 是 NULL，則叫用無效參數處理常式，如參數驗證中所述。如果允許繼續執行，則函式會回傳並將 errno 設定為 EINVAL。如需 errno 和錯誤碼的詳細資訊，請參閱 errno 常數。

這個函式更安全的版本可用;請參閱 clearerr_s。

需求

常式	必要的標頭
clearerr	<stdio.h>

如需其他相容性資訊，請參閱＜簡介＞中的相容性。

範例

// 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" );
}