C

strerror

strerror, strerror_s, strerrorlen_s

在头文件中定义
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 是一个空指针

如果写入buf发生在数组的末尾(这可能发生在buf指向的缓冲区的大小小于错误消息中小于bufsz的字符数时可能发生),则行为未定义。

3)计算如果使用errnum调用时,strerror_s会编写的未截断的特定于语言环境的错误消息的长度。 该长度不包括空终止符。 与所有边界检查函数一样,只有在__STDC_LIB_EXT1__由实现定义且用户在包含string.h之前将__STDC_WANT_LIB_EXT1__定义为整数常量1时,strerror_s和strerrorlen_s才能保证可用。

参数

差错编号-整数值是指错误代码
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, "zh_CN.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 Chinese: %s\n", errmsg #endif } }

可能的输出:

File opening error: No such file or directory Now in German: Datei oder Verzeichnis nicht gefunden Now in Chinese: 没有那个文件或目录

参考

  • C11标准(ISO / IEC 9899:2011):

扩展内容

PERROR显示当前错误对应的字符串到stderr(函数)
errno宏扩展到POSIX兼容的线程局部错误号变量(宏变量)

| 用于strerror的C ++文档 |