错误处理

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

诊断库

异常处理 exception uncaught_exceptionuncaught_exceptions (直到 C++20*)  (C++17) exception_ptr (C++11) make_exception_ptr (C++11) current_exception (C++11) rethrow_exception (C++11) nested_exception (C++11) throw_with_nested (C++11) rethrow_if_nested (C++11) 异常处理失败 terminate terminate_handler get_terminate (C++11) set_terminate bad_exception unexpected (直到 C++17*) unexpected_handler (直到 C++17*) get_unexpected (直到 C++17*) set_unexpected (直到 C++17*) 错误号 错误代码 errno

异常类别 logic_error invalid_argument domain_error length_error out_of_range runtime_error range_error overflow_error underflow_error tx_exception (TM TS) 系统错误 error_category (C++11) generic_category (C++11) system_category (C++11) error_condition (C++11) errc (C++11) error_code (C++11) system_error (C++11) 断言 assert 堆栈跟踪 stacktrace_entry (C++23) basic_stacktrace (C++23)

 

异常处理

头文件 <exception> 提供了 C++ 程序中与异常处理相关的几个类和函数。

定义在头文件 <exception> 中
exception	标准库组件抛出的异常的基类 (类)
捕获和存储异常对象
uncaught_exceptionuncaught_exceptions (C++20 中已删除*)(C++17)	检查是否正在进行异常处理 (函数)
exception_ptr (C++11)	用于处理异常对象的共享指针类型 (typedef)
make_exception_ptr (C++11)	从异常对象创建 std::exception_ptr (函数模板)
current_exception (C++11)	将当前异常捕获到 std::exception_ptr 中 (函数)
rethrow_exception (C++11)	从 std::exception_ptr 中抛出异常 (函数)
nested_exception (C++11)	一个混合类型，用于捕获和存储当前异常 (类)
throw_with_nested (C++11)	使用混合的 std::nested_exception 抛出其参数 (函数模板)
rethrow_if_nested (C++11)	从 std::nested_exception 中抛出异常 (函数模板)
处理异常处理中的失败
定义在头文件 <exception> 中
terminate	当异常处理失败时调用的函数 (函数)
terminate_handler	由 std::terminate 调用的函数的类型 (typedef)
get_terminate (C++11)	获取当前 terminate_handler (函数)
set_terminate	更改由 std::terminate 调用的函数 (函数)
bad_exception	当 std::current_exception 无法复制异常对象时抛出的异常 (类)
处理异常规范违规 (C++17 中已删除)
unexpected (C++11 中已弃用)(C++17 中已删除)	当违反动态异常规范时调用的函数 (函数)
unexpected_handler (C++11 中已弃用)(C++17 中已删除)	由 std::unexpected 调用的函数的类型 (typedef)
get_unexpected (C++11 中已弃用)(C++17 中已删除)	获取当前 unexpected_handler (函数)
set_unexpected (C++11 中已弃用)(C++17 中已删除)	更改由 std::unexpected 调用的函数 (函数)

异常类别

头文件 <stdexcept> 中预定义了一些方便类，用于报告特定的错误条件。这些类可以分为两类：逻辑 错误和运行时 错误。逻辑错误是程序中逻辑错误的结果，可能是可以避免的。运行时错误是由于程序范围之外的事件造成的，不能轻易预测。

定义在头文件 <stdexcept> 中
logic_error	异常类，用于指示违反逻辑前提或类不变式 (类)
invalid_argument	异常类，用于报告无效参数 (类)
domain_error	异常类，用于报告域错误 (类)
length_error	异常类，用于报告尝试超过允许的最大大小 (类)
out_of_range	异常类，用于报告超出预期范围的参数 (类)
runtime_error	异常类，用于指示仅在运行时可检测到的条件 (类)
range_error	异常类，用于报告内部计算中的范围错误 (类)
overflow_error	异常类，用于报告算术溢出 (类)
underflow_error	异常类，用于报告算术下溢 (类)
tx_exception (TM TS)	用于取消原子事务的异常类 （类模板）

错误编号

定义在头文件 <cerrno> 中
errno	宏，扩展为 POSIX 兼容的线程局部错误编号变量 (宏变量)
E2BIG, EACCES, ..., EXDEV	标准 POSIX 兼容错误条件的宏 (宏常量)

系统错误

头文件 <system_error> 定义了用于报告来自操作系统、流 I/O、std::future 或其他低级 API 的错误条件的类型和函数。

定义在头文件 <system_error> 中
error_category (C++11)	错误类别的基类 (类)
generic_category (C++11)	识别通用错误类别 (函数)
system_category (C++11)	识别操作系统错误类别 (函数)
error_condition (C++11)	保存可移植的错误代码 (类)
errc (C++11)	std::error_condition 枚举，列出所有标准 <cerrno> 宏常量 (类)
error_code (C++11)	保存平台相关的错误代码 (类)
system_error (C++11)	用于报告具有 error_code 的条件的异常类 (类)

断言

断言有助于在程序中实现对先决条件的检查。

定义在头文件 <cassert> 中
assert	如果用户指定的条件不为 true，则中止程序。可能在发布版本中被禁用。 (函数宏)

堆栈跟踪

定义在头文件 <stacktrace> 中
stacktrace_entry (C++23)	堆栈跟踪中评估的表示 (类)
basic_stacktrace (C++23)	调用序列的近似表示，由堆栈跟踪条目组成 (类模板)

另请参阅

static_assert 声明 (C++11)	执行编译时断言检查
C 文档 用于 错误处理