std::strerror

< cpp‎ | string‎ | byte
定义于头文件 <cstring>
char* strerror( int errnum );

返回指向系统错误码 errnum 的文本表示的指针,它等同于 std::perror() 会打印的描述。

通常从 errno 对象获得 errnum ,不过函数接受任何 int 类型值。字符串的内容是本地环境限定的。

程序必须不修改返回的字符串,但对 strerror 函数的后继调用可能重写该字符串。不要求 strerror 为线程安全。实现可以返回指向静态只读字符串字面量的不同指针,或反复返回指向静态缓冲区的同一指针而 strerror 于该缓冲区中放置字符串。

参数

errnum - 指代错误码的整数值

返回值

指向对应 errno 错误码 errnum 的空终止字节串的指针。

注意

POSIX 允许对 strerror 的后继调用非法化先前调用所返回的指针值。它亦指定控制这些消息的 LC_MESSAGES 本地环境平面。

示例

#include <iostream>
#include <cmath>
#include <cerrno>
#include <cstring>
#include <clocale>
 
int main()
{
    double not_a_number = std::log(-1.0);
    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';
    }
}

可能的输出:

log(-1) failed: Numerical argument out of domain
Or, in German, Das numerische Argument ist ausserhalb des Definitionsbereiches

参阅

显示对应当前错误的字符串于 stderr
(函数)
兼容标准 POSIX 的错误条件的宏
(宏常量)