std::range_error
来自 cppreference.cn
| 定义于头文件 <stdexcept> |
||
| class range_error; |
||
定义一个作为异常抛出的对象类型。它可用于报告范围错误（即，计算结果无法由目标类型表示的情况）。
唯一抛出此异常的标准库组件是 std::wstring_convert::from_bytes 和 std::wstring_convert::to_bytes。
标准库组件中的数学函数不抛出此异常（数学函数按照 math_errhandling 中指定的方式报告范围错误）。
继承图
目录 |
[编辑] 成员函数
| (构造函数) |
使用给定消息构造新的 range_error 对象(公开成员函数) |
| operator= |
替换 range_error 对象(公开成员函数) |
std::range_error::range_error
| range_error( const std::string& what_arg ); |
(1) | |
| range_error( const char* what_arg ); |
(2) | |
| range_error( const range_error& other ); |
(3) | (C++11 起无异常抛出) |
3) 复制构造函数。如果 *this 和 other 都具有动态类型
std::range_error，则 std::strcmp(what(), other.what()) == 0。复制构造函数不能抛出异常。参数
| what_arg | - | 解释性字符串 |
| 其他 | - | 要拷贝的另一个异常对象 |
异常
1,2) 可能抛出 std::bad_alloc。
注意
由于不允许复制 std::range_error 抛出异常，因此此消息通常在内部存储为单独分配的引用计数字符串。这也是为什么没有接受 std::string&& 的构造函数：无论如何它都必须复制内容。
在解决 LWG 问题 254 之前，非复制构造函数只能接受 std::string。为了构造 std::string 对象，它强制进行动态分配。
在解决 LWG 问题 471 之后，派生标准异常类必须具有公共可访问的复制构造函数。只要通过 what() 获得的解释性字符串对于原始对象和复制对象相同，它就可以隐式定义。
std::range_error::operator=
| range_error& operator=( const range_error& other ); |
(C++11 起无异常抛出) | |
将内容分配给 other 的内容。如果 *this 和 other 都具有动态类型 std::range_error，则赋值后 std::strcmp(what(), other.what()) == 0。复制赋值运算符不能抛出异常。
参数
| 其他 | - | 用于赋值的另一个异常对象 |
返回值
*this
注意
在解决 LWG 问题 471 之后，派生标准异常类必须具有公共可访问的复制赋值运算符。只要通过 what() 获得的解释性字符串对于原始对象和复制对象相同，它就可以隐式定义。
继承自 std::exception
成员函数
| [virtual] |
销毁异常对象 ( std::exception 的虚公共成员函数) |
| [virtual] |
返回解释字符串 ( std::exception 的虚公共成员函数) |
[编辑] 缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 发布时的行为 | 正确的行为 |
|---|---|---|---|
| LWG 254 | C++98 | 缺少接受 const char* 的构造函数 | 已添加 |
| LWG 471 | C++98 | std::range_error 的解释性字符串解释性字符串是实现定义的 |
它们与原始 std::runtime_error 对象的原始的 std::range_error 对象 |
