std::out_of_range

定义作为异常抛出的对象类型。它报告访问试图受定义范围外的元素所带来的错误。

它可能为 std::bitset 与 std::basic_string 的成员函数、 std::stoi 与 std::stod 函数族及有边界检查的成员访问函数（例如 std::vector::at 与 std::map::at ）所抛出。

继承图

(构造函数)	构造拥有给定消息的新 `out_of_range` 对象 (公开成员函数)
operator=	替换 `out_of_range` 对象 (公开成员函数)
what	返回解释字符串 (公开成员函数)

std::out_of_range::out_of_range

out_of_range( const std::string& what_arg );	(1)
out_of_range( const char* what_arg );	(2)	(C++11 起)
	(3)
out_of_range( const out_of_range& other );			(C++11 前)
out_of_range( const out_of_range& other ) noexcept;			(C++11 起)

1-2) 构造以 what_arg 为解释字符串的异常对象，解释字符串能通过 what() 访问。

3) 复制构造函数。若 *this 与 other 均拥有动态类型 std::out_of_range 则 std::strcmp(what(), other.what()) == 0 。 (C++11 起)

what_arg	-	解释字符串
other	-	要复制的另一异常对象

1-2) 可能抛出 std::bad_alloc

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

out_of_range& operator=( const out_of_range& other );		(C++11 前)
out_of_range& operator=( const out_of_range& other ) noexcept;		(C++11 起)

以 other 的内容赋值。若 *this 与 other 均拥有动态类型 std::out_of_range 则赋值后 std::strcmp(what(), other.what()) == 0 。 (C++11 起)

other

用以赋值的另一异常对象

*this

virtual const char* what() const throw();		(C++11 前)
virtual const char* what() const noexcept;		(C++11 起)

返回解释字符串。

（无）

指向有解释信息的空终止字符串的指针。该字符串适合转换并显示为 std::wstring 。保证该指针至少到获得它来源的异常对象被销毁，或在该异常对象上调用非 const 成员函数（例如复制赋值运算符）为止合法。

允许但不要求实现覆写 what() 。

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

标准错误条件 std::errc::result_out_of_range 典型地指示结果而非输入在范围外的条件，而且与 std::range_error 及 ERANGE 关联更紧密。

at	访问指定字符，有边界检查 (`std::basic_string<CharT,Traits,Allocator>` 的公开成员函数)