命名空间
变体
操作

std::strerror

来自 cppreference.cn
< cpp‎ | string‎ | byte
在头文件 <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