std::out_of_range

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

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

它可能为 std::bitsetstd::basic_string 的成员函数、 std::stoistd::stod 函数族及有边界检查的成员访问函数(例如 std::vector::atstd::map::at )所抛出。

cpp/error/exceptioncpp/error/logic errorstd-out of range-inheritance.svg
关于这幅图像

继承图

目录

成员函数

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

std::out_of_range::out_of_range

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

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

因为不允许 std::exception 的复制抛出异常,此信息典型地在内部作为分离分配的引用计数字符串存储。这也是构造函数不采用 std::string&& 参数的理由:无论如何它必须复制内容。

参数

what_arg - 解释性字符串

异常

可能抛出 std::bad_alloc

继承自 std::exception

成员函数

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

注意

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

参阅

访问指定字符,有边界检查
(std::basic_string 的公开成员函数)

版本历史

  • (当前 | 先前 2017年8月26日 (六) 21:38Fruderica讨论 | 贡献. . (1,033字节) (+231). . (撤销)
  • 当前 | 先前 2013年7月2日 (二) 09:04P12bot讨论 | 贡献 . . (802字节) (-25). . (Use {{lc}}. Update links. Various fixes.) (撤销)
  • 当前 | 先前 2012年11月2日 (五) 15:30P12bot讨论 | 贡献 . . (827字节) (+241). . (r2.7.3) (机器人添加:de, en, es, fr, it, ja, pt, ru) (撤销)
  • 当前 | 先前 2012年10月26日 (五) 11:37P12讨论 | 贡献 . . (586字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前 2012年10月26日 (五) 07:00TranslationBot讨论 | 贡献. . (586字节) (-9). . (Translated from the English version using Google Translate) (撤销)
  • 当前 | 先前 2012年10月25日 (四) 14:25P12讨论 | 贡献 . . (595字节) (0). . (1个修订: Translate from the English version) (撤销)
  • 当前 | 先前) 2012年10月25日 (四) 13:00TranslationBot讨论 | 贡献. . (595字节) (+595). . (Translated from the English version using Google Translate)