std::strerror
来自 cppreference.cn
在头文件 <cstring> 中定义 |
||
char* strerror( int errnum ); |
||
返回系统错误代码 errnum 的文本描述的指针,与 std::perror() 打印的描述相同。
errnum 通常从 errno
变量获取,但该函数接受任何 int 类型的值。字符串的内容是区域设置特定的。
返回的字符串不得被程序修改,但可能会被后续的 strerror
函数调用覆盖。strerror
不要求是线程安全的。实现可以返回指向静态只读字符串字面量的不同指针,也可以反复返回相同的指针,指向 strerror
放置字符串的静态缓冲区。
目录 |
[编辑] 参数
errnum | - | 表示错误代码的整数值 |
[编辑] 返回值
指向与 errno 错误代码 errnum 对应的空终止字节字符串的指针。
[编辑] 注意
POSIX 允许后续调用 strerror
使早期调用返回的指针值失效。它还规定 LC_MESSAGES 区域设置刻面控制这些消息的内容。
POSIX 定义了一个线程安全版本,名为 strerror_r
。Glibc 定义了一个不兼容的版本。
[编辑] 示例
运行此代码
#include <cerrno> #include <clocale> #include <cmath> #include <cstring> #include <iostream> int main() { const double not_a_number = std::log(-1.0); std::cout << not_a_number << '\n'; if (errno == EDOM) { std::cout << "log(-1) failed: " << std::strerror(errno) << '\n'; std::setlocale(LC_MESSAGES, "de_DE.utf8"); std::cout << "Or, in German, " << std::strerror(errno) << '\n'; } }
可能的输出
nan log(-1) failed: Numerical argument out of domain Or, in German, Das numerische Argument ist ausserhalb des Definitionsbereiches
[编辑] 另请参阅
将当前错误的字符串显示到 stderr (函数) | |
标准 POSIX 兼容错误条件的宏 (宏常量) | |
C 文档 for strerror
|