strerror、_strerror、_wcserror、__wcserror

获取系统错误消息字符串（strerror、_wcserror）或格式化用户提供的错误消息字符串（_strerror、__wcserror）。 提供这些函数的更多安全版本；请参见 strerror_s、_strerror_s、_wcserror_s、__wcserror_s。

char *strerror(    int errnum  ); char *_strerror(    const char *strErrMsg  ); wchar_t * _wcserror(    int errnum  ); wchar_t * __wcserror(    const wchar_t *strErrMsg  );

参数

• errnum
  错误号。

• strErrMsg
  用户提供的消息。

返回值

所有这些函数都将返回指向错误消息字符串的指针。 后续调用可覆盖该字符串。

备注

strerror 函数可将 errnum 映射到错误消息字符串并返回指向该字符串的指针。 实际上，strerror 和 _strerror 都不会打印该消息：若要打印消息，你必须调用输出函数，例如 fprintf：

if (( _access( "datafile",2 )) == -1 )
   fprintf( stderr, _strerror(NULL) );

如果将 strErrMsg 作为 NULL 传递，则 _strerror 将返回指向字符串的指针，该字符串包含产生错误的最后一个库调用的系统错误消息。 错误消息字符串以换行符 ('\n') 结尾。 如果 strErrMsg 不等于 NULL，则 _strerror 将返回指向字符串的指针，该字符串包含（按顺序）你的字符串消息、一个冒号、一个空格、产生错误的最后一个库调用的系统错误消息，以及一个换行符。 你的字符串消息长度最多可达 94 个字符。

_strerror 的实际错误数存储在 errno 变量中。 若要生成准确的结果，请在库例程返回错误后立即调用 _strerror。 否则，对 strerror 或 _strerror 的后续调用可以覆盖 errno 值。

_wcserror 和 __wcserror 分别是 strerror 和 _strerror 的宽字符版本。

_strerror、_wcserror 和 __wcserror 不是 ANSI 定义的一部分；它们是 Microsoft 扩展，我们建议你不要在需要可移植代码的位置上使用它们。 对于 ANSI 兼容性，请改为使用 strerror。

若要获取错误字符串，我们建议使用 strerror 或 _wcserror，而不是已弃用的宏 _sys_errlist 和 _sys_nerr，以及已弃用的内部函数 __sys_errlist 和 __sys_nerr。

一般文本例程映射

要求

有关其他兼容性信息，请参见兼容性。

示例

请参阅 perror 示例。

.NET Framework 等效项

System::Exception::Message

请参见

参考

字符串操作 (CRT)

clearerr

ferror

perror、_wperror