std::runtime_error
来自 cppreference.com
定义在头文件 <stdexcept> 中 |
||
class runtime_error; |
||
定义了一种作为异常抛出的对象类型。它报告由于程序范围之外的事件而发生的错误,这些错误难以预测。
继承图
类型为 std::runtime_error
的异常由以下标准库组件抛出
(自 C++20 起) |
此外,以下标准异常类型是从 std::runtime_error
派生的
(自 C++11 起) |
(自 C++17 起) |
(自 C++20 起) |
内容 |
[编辑] 成员函数
(构造函数) |
用给定的消息构造一个新的 runtime_error 对象(公共成员函数) |
operator= |
替换 runtime_error 对象(公共成员函数) |
std::runtime_error::runtime_error
runtime_error( const std::string& what_arg ); |
(1) | |
runtime_error( const char* what_arg ); |
(2) | |
runtime_error( const runtime_error& other ); |
(3) | (自 C++11 起,无异常) |
3) 复制构造函数。如果 *this 和 other 都具有动态类型
std::runtime_error
,则 std::strcmp(what(), other.what()) == 0。复制构造函数不会抛出任何异常。参数
what_arg | - | 解释性字符串 |
other | - | 要复制的另一个异常对象 |
异常
1,2) 可能抛出 std::bad_alloc.
注释
由于不允许复制 std::runtime_error
抛出异常,因此此消息通常在内部存储为一个单独分配的引用计数字符串。这也是没有采用 std::string&&
的构造函数的原因:无论如何都要复制内容。
在解决 LWG 问题 254 之前,非复制构造函数只能接受 std::string。为了构造一个 std::string 对象,必须进行动态分配。
在解决 LWG 问题 471 之后,派生的标准异常类必须具有一个公共可访问的复制构造函数。只要通过 what()
获取的解释性字符串对于原始对象和复制对象相同,就可以隐式定义它。
std::runtime_error::operator=
runtime_error& operator=( const runtime_error& other ); |
(自 C++11 起,无异常) | |
用 other 的内容进行赋值。如果 *this 和 other 都具有动态类型 std::runtime_error
,则赋值后 std::strcmp(what(), other.what()) == 0。复制赋值运算符不会抛出任何异常。
参数
other | - | 要赋值的另一个异常对象 |
返回值
*this
注释
在解决 LWG 问题 471 之后,派生的标准异常类必须具有一个公共可访问的复制赋值运算符。只要通过 what()
获取的解释性字符串对于原始对象和复制对象相同,就可以隐式定义它。
从 std::exception 继承
成员函数
[虚拟] |
销毁异常对象 ( std::exception 的虚拟公共成员函数) |
[虚拟] |
返回解释性字符串 ( std::exception 的虚拟公共成员函数) |
[编辑] 缺陷报告
以下行为变更的缺陷报告被追溯应用于先前发布的 C++ 标准。
DR | 应用于 | 已发布的行为 | 正确行为 |
---|---|---|---|
LWG 254 | C++98 | 缺少接受 const char* 的构造函数 | 已添加 |
LWG 471 | C++98 | std::runtime_error 的解释字符串副本是实现定义的 |
它们与 原始 std::runtime_error 对象的解释字符串相同 |