clearerr_s

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

ストリームのエラーインジケーターをリセットします。この関数は、「CRT のセキュリティ機能」に説明されているように、clearerr のセキュリティが強化されたバージョンです。

errno_t clearerr_s(
   FILE *stream 
);

パラメーター

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

戻り値

正常終了した場合は 0、stream が NULL の場合は EINVAL を返します。

解説

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

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

必要条件

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

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

使用例

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

FakePre-57919d2337c7460fab9035752b7236bf-f34b9e7a0d874595847b6e312d0fa1e1