clearerr

[アーティクル]
08/09/2011

ストリームのエラーインジケーターをリセットします。この関数のセキュリティが強化されたバージョンについては、「clearerr_s」を参照してください。

void clearerr(
   FILE *stream 
);

パラメーター

stream
FILE 構造体へのポインター。

解説

clearerr 関数は、stream のエラーインジケーターおよび EOF (end-of-file) インジケーターをリセットします。エラーインジケーターは自動的にクリアされないため、指定されたストリームのエラーインジケーターが設定されると、そのストリームに対する操作は、clearerr、fseek、fsetpos、または rewind のいずれかが呼び出されるまでエラー値を返し続けます。

stream が NULL の場合は、「パラメーターの検証」に説明されているように、無効なパラメーターハンドラーが呼び出されます。実行の継続が許可された場合、この関数は errno を EINVAL に設定し、戻ります。 errno とエラーコードの詳細については、「errno 定数」を参照してください。

この関数のセキュリティが強化されたバージョンを使用できるようになりました。「clearerr_s」を参照してください。

必要条件

ルーチン	必須ヘッダー
clearerr	<stdio.h>

互換性の詳細については、「C ランタイムライブラリ」の「互換性」を参照してください。

使用例

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

FakePre-0886b4e9e9bf460bb255e1aa9c6fd635-5fc7748f322f466f9425d729d2adf6a7