C++ 参考手册

位置:首页 > C++ 参考手册 >错误处理 > std::range_error

定义于头文件 <stdexcept>
class range_error;

定义作为异常抛出的对象类型。它能用于报告值域错误(即计算结果不能以目标类型表示的情形)。

仅有的抛出此异常的标准库组件是 std::wstring_convert::from_bytesstd::wstring_convert::to_bytes

标准库组件中的数学函数不抛此异常(数学函数报告 math_errhandling 中指定的值域错误)。

cpp/error/exceptioncpp/error/runtime errorstd-range error-inheritance.svg

继承图

成员函数

(构造函数)
构造异常对象
(公开成员函数)

std::range_error::range_error

explicit range_error( const std::string& what_arg );
(1)
explicit range_error( const char* what_arg );
(2) (C++11 起)

what_arg 为解释字符串构造异常对象,能通过 what() 访问它。

因为不容许复制 std::range_error 抛出异常,通常将此消息在内部存储为分离分配的引用计数字符串。这也是构造函数不接收 std::string&& 参数的理由:无论如何它必须复制内容。

参数

what_arg - 解释字符串

异常

可能抛出 std::bad_alloc

继承自 std::exception

成员函数

析构该异常对象
(std::exception 的虚公开成员函数)
[虚]
返回解释性字符串
(std::exception 的虚公开成员函数)