ferror
ストリームのエラーをテストします。
構文
int ferror(
FILE *stream
);
パラメーター
stream
FILE
構造体へのポインター。
戻り値
stream
のエラーが発生していない場合、ferror
は 0 を返します。 それ以外の場合は、0 以外の値を返します。 ストリームがNULL
されている場合、パラメーターの検証で説明されているように、ferror
は無効なパラメーター ハンドラー呼び出します。 実行の継続が許可された場合、この関数は errno
を EINVAL
に設定し、0 を返します。
リターン コードの詳細については、「errno
、_doserrno
、_sys_errlist
、および _sys_nerr
」を参照してください。
解説
ferror
ルーチン (関数とマクロの両方として実装されています) は、stream
に関連付けられているファイルの読み取りエラーまたは書き込みエラーをテストします。 エラーが発生した場合、ストリームが終了するか巻き戻されるまで、または clearerr
が呼び出されるまで、ストリームのエラー インジケーターは設定されたままになります。
既定では、この関数のグローバル状態の適用対象は、アプリケーションになります。 この動作を変更するには、「CRT でのグローバル状態」を参照してください。
要件
機能 | 必須ヘッダー |
---|---|
ferror |
<stdio.h> |
互換性の詳細については、「 Compatibility」を参照してください。
例
feof
の例を参照してください。
関連項目
エラー処理
ストリーム入出力
clearerr
_eof
feof
fopen
, _wfopen
perror
, _wperror