C++ 参考手册
- C++11
- C++14
- C++17
- C++20
- C++ 编译器支持情况表
- 独立与宿主实现
- C++ 语言
- C++ 关键词
- 预处理器
- C++ 标准库头文件
- 具名要求
- 功能特性测试 (C++20)
- 工具库
- 类型支持(基本类型、RTTI、类型特性)
- 概念库 (C++20)
- 错误处理
- 动态内存管理
- 日期和时间工具
- 字符串库
- std::basic_string
- std::basic_string_view
- 空终止字节字符串
- std::isalnum
- std::isalpha
- std::islower
- std::isupper
- std::isdigit
- std::isxdigit
- std::isblank
- std::iscntrl
- std::isgraph
- std::isspace
- std::isprint
- std::ispunct
- std::tolower
- std::toupper
- std::atof
- std::atoi, std::atol, std::atoll
- std::strtol, std::strtoll
- std::strtoul, std::strtoull
- std::strtof, std::strtod, std::strtold
- std::strtoimax, std::strtoumax
- std::strcpy
- std::strncpy
- std::strcat
- std::strncat
- std::strxfrm
- std::strlen
- std::strcmp
- std::strncmp
- std::strcoll
- std::strchr
- std::strrchr
- std::strspn
- std::strcspn
- std::strpbrk
- std::strstr
- std::strtok
- std::memchr
- std::memcmp
- std::memset
- std::memcpy
- std::memmove
- std::strerror
- 空终止多字节字符串
- 空终止宽字符串
- std::char_traits
- 注释
- 容器库
- 迭代器库
- 范围库 (C++20)
- 算法库
- 数值库
- 输入/输出库
- 文件系统库
- 本地化库
- 正则表达式库
- 原子操作库
- 线程支持库
- 实验性 C++ 特性
- 有用的资源
- 索引
- std 符号索引
- 协程支持 (C++20)
- C++ 关键词
std::strerror
定义于头文件 <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 的错误条件的宏 (宏常量) |