命名空间
变体
操作

strerror, strerror_s, strerrorlen_s

来自 cppreference.cn
< c‎ | string‎ | byte
定义于头文件 <string.h>
char* strerror( int errnum );
(1)
errno_t strerror_s( char *buf, rsize_t bufsz, errno_t errnum );
(2) (C11 起)
size_t strerrorlen_s( errno_t errnum );
(3) (C11 起)
1) 返回指向系统错误码 errnum 的文本描述的指针,该描述与 perror() 打印的描述相同。
errnum 通常从 errno 变量获取,但函数接受任何 int 类型的值。字符串内容是区域设置相关的。
返回的字符串不能被程序修改,但可能会被后续的 strerror 函数调用覆盖。strerror 不要求是线程安全的。实现可能返回指向静态只读字符串字面量的不同指针,或者可能反复返回相同的指针,指向 strerror 放置字符串的静态缓冲区。
2)(1) 相同,但消息被复制到用户提供的存储 buf 中。写入的字节数不超过 bufsz-1,缓冲区始终以空字符终止。如果消息因缓冲区大小限制而必须截断,并且 bufsz 大于 3,则只写入 bufsz-4 字节,并在空字符终止符之前附加字符 "..."。此外,运行时会检测到以下错误,并调用当前安装的约束处理程序函数
  • buf 是空指针
  • bufsz 为零或大于 RSIZE_MAX
如果写入 buf 超出数组末尾,则行为是未定义的,这可能发生在 buf 指向的缓冲区大小小于错误消息中的字符数,而错误消息中的字符数又小于 bufsz 的情况下。
3) 计算 strerror_s 在调用 errnum 时将写入的未截断的区域设置相关错误消息的长度。长度不包括空终止符。
与所有边界检查函数一样,只有当实现定义了 __STDC_LIB_EXT1__ 并且用户在包含 <string.h> 之前将 __STDC_WANT_LIB_EXT1__ 定义为整数常量 1 时,才能保证 strerror_sstrerrorlen_s 可用。

目录

[编辑] 参数

errnum - 表示错误码的整数值
buf - 指向用户提供缓冲区的指针
bufsz - 用户提供缓冲区的大小

[编辑] 返回值

1) 指向与 errno 错误码 errnum 对应的空终止字节字符串的指针。
2) 如果整个消息成功存储在 buf 中,则为零,否则为非零。
3) strerror_s 将返回的消息的长度(不包括空终止符)

[编辑] 注意

POSIX 允许后续对 strerror 的调用使早期调用返回的指针值失效。它还指定 LC_MESSAGES 区域设置方面控制这些消息的内容。

strerror_s 是唯一允许截断的边界检查函数,因为提供尽可能多的关于失败的信息被认为是更可取的。POSIX 还为类似目的定义了 strerror_r

[编辑] 示例

#define __STDC_WANT_LIB_EXT1__ 1
#include <stdio.h>
#include <errno.h>
#include <string.h>
#include <locale.h>
 
int main(void)
{
    FILE *fp = fopen(tmpnam((char[L_tmpnam]){0}), "r");
    if(fp==NULL) {
        printf("File opening error: %s\n", strerror(errno));
        setlocale(LC_MESSAGES, "de_DE.utf8");
        printf("Now in German: %s\n", strerror(errno));
#ifdef __STDC_LIB_EXT1__
        setlocale(LC_ALL, "ja_JP.utf8"); // printf needs CTYPE for multibyte output
        size_t errmsglen = strerrorlen_s(errno) + 1;
        char errmsg[errmsglen]; 
        strerror_s(errmsg, errmsglen, errno);
        printf("Now in Japanese: %s\n", errmsg);
#endif
    }
}

可能的输出

File opening error: No such file or directory
Now in German: Datei oder Verzeichnis nicht gefunden
Now in Japanese: そのようなファイル、又はディレクトリはありません

[编辑] 参考资料

  • C11 标准 (ISO/IEC 9899:2011)
  • 7.24.6.2 strerror 函数 (p: 371)
  • K.3.7.4.2 strerror_s 函数 (p: 622)
  • K.3.7.4.3 strerrorlen_s 函数 (p: 623)
  • C99 标准 (ISO/IEC 9899:1999)
  • 7.21.6.2 strerror 函数 (p: 334)
  • C89/C90 标准 (ISO/IEC 9899:1990)
  • 4.11.6.2 strerror 函数

[编辑] 另请参阅

stderr 显示与当前错误对应的字符串
(函数) [编辑]
扩展为 POSIX 兼容的线程局部错误码变量的宏
(宏变量) [编辑]
C++ 文档,关于 strerror