errno、_doserrno、_sys_errlist、および _sys_nerrerrno, _doserrno, _sys_errlist, and _sys_nerr

• 11/04/2016
• • T
  • o
  • O

プログラムの実行中に設定されるエラー コードと、エラー コードに相当する表示用の文字列を保持するグローバル マクロ。Global macros that hold error codes that are set during program execution, and string equivalents of the error codes for display.

構文Syntax

#define errno   (*_errno())
#define _doserrno   (*__doserrno())
#define _sys_errlist (__sys_errlist())
#define _sys_nerr (*__sys_nerr())

解説Remarks

errno と _doserrno は両方とも、プログラムの起動中にランタイムによって 0 に設定されます。Both errno and _doserrno are set to 0 by the runtime during program startup. システム レベルの呼び出しでエラーが発生すると、errno が設定されます。errno is set on an error in a system-level call. errno には最後の呼び出しで設定された値が保持されるため、この値は、その後の呼び出しによって変更される可能性があります。Because errno holds the value for the last call that set it, this value may be changed by succeeding calls. エラーの発生時に errno を設定するランタイム ライブラリの呼び出しでは、正常に完了しても、errno はクリアされません。Run-time library calls that set errno on an error do not clear errno on success. errno は、これを設定する呼び出しの直前に _set_errno(0) を呼び出して必ずクリアし、呼び出しの直後に確認します。Always clear errno by calling _set_errno(0) immediately before a call that may set it, and check it immediately after the call.

エラーの発生時、errno は、必ずしもシステム呼び出しで返されるエラー コードと同じ値に設定されるとは限りません。On an error, errno is not necessarily set to the same value as the error code returned by a system call. I/O 操作では、_doserrno に errno コードと同等のオペレーティング システムのエラー コードが格納されます。For I/O operations, _doserrno stores the operating-system error-code equivalents of errno codes. I/O 以外の操作については、ほとんどの場合、_doserrno の値は設定されません。For most non-I/O operations, the value of _doserrno is not set.

各 errno 値は、_sys_errlist のエラー メッセージに関連付けられており、これは perror 関数のいずれかを使用して出力するか、strerror または strerror_s 関数のいずれかを使用して文字列に格納できます。Each errno value is associated with an error message in _sys_errlist that can be printed by using one of the perror functions, or stored in a string by using one of the strerror or strerror_s functions. perror および strerror 関数は、_sys_errlist 配列と _sys_nerr (_sys_errlist の要素の数) を使用して、エラー情報を処理します。The perror and strerror functions use the _sys_errlist array and _sys_nerr—the number of elements in _sys_errlist—to process error information. _sys_errlist および _sys_nerr への直接アクセスは、コードのセキュリティ上の理由から非推奨とされます。Direct access to _sys_errlist and _sys_nerr is deprecated for code-security reasons. 次に示すように、グローバル マクロではなく、より安全かつ機能的なバージョンを使用することをお勧めします。We recommend that you use the more secure, functional versions instead of the global macros, as shown here:

ライブラリの数値演算ルーチンでは、_matherr を呼び出して errno を設定します。Library math routines set errno by calling _matherr. 別の方法で数値演算エラーを処理するには、_matherr リファレンスの説明に従って独自のルーチンを記述し、_matherr という名前を付けます。To handle math errors differently, write your own routine according to the _matherr reference description and name it _matherr.

次の表のすべての errno 値は、の定義済み定数で、 <errno.h> UNIX と互換性があります。All errno values in the following table are predefined constants in <errno.h>, and are UNIX-compatible. ERANGE、EILSEQ、および EDOM のみが、ISO C99 標準で指定されます。Only ERANGE, EILSEQ, and EDOM are specified in the ISO C99 standard.

要件Requirements

_doserrno、_sys_errlist、および _sys_nerr マクロは Microsoft 拡張機能です。The _doserrno, _sys_errlist, and _sys_nerr macros are Microsoft extensions. 互換性について詳しくは、「 Compatibility」をご覧ください。For more compatibility information, see Compatibility.

関連項目See also

グローバル変数Global Variables
errno 定数errno Constants
perror、_wperrorperror, _wperror
strerror、_strerror、_wcserror、 _ _wcserrorstrerror, _strerror, _wcserror, __wcserror
strerror_s、_strerror_s、_wcserror_s、 _ _wcserror_sstrerror_s, _strerror_s, _wcserror_s, __wcserror_s
_get_doserrno_get_doserrno
_set_doserrno_set_doserrno
_get_errno_get_errno
_set_errno_set_errno