clearerr_s
更新 : 2007 年 11 月
ストリームのエラー インジケータをリセットします。この関数は、「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();
}
}
}
n
Write error: Bad file descriptor
Will input cause an error? n
.NET Framework の相当するアイテム
適用できません。標準 C 関数を呼び出すには、PInvoke を使用します。詳細については、「プラットフォーム呼び出しの例」を参照してください。