std::unexpected

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用程序库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

执行支持库 (C++26)

技术规范

符号索引

外部库

 

诊断库

异常处理 异常 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> 中
void unexpected();		(直到 C++11)
[[noreturn]] void unexpected();		(在 C++11 中弃用) (在 C++17 中移除)

当违反了 动态异常规范 时，C++ 运行时会调用 std::unexpected()：从函数抛出异常，该函数的异常规范禁止此类型的异常。

std::unexpected() 也可以直接从程序中调用。

在这两种情况下，std::unexpected 都会调用当前安装的 std::unexpected_handler。默认的 std::unexpected_handler 会调用 std::terminate.

如果析构函数在堆栈展开期间重置了 unexpected 处理程序，并且展开后来导致调用了 unexpected，那么将在 throw 表达式结束时安装的处理程序是将被调用的处理程序（注意：重新抛出是否应用了新的处理程序是模棱两可的）。	(直到 C++11)
如果析构函数在堆栈展开期间重置了 unexpected 处理程序，那么如果展开后来导致调用了 unexpected，则调用哪个处理程序是未定义的。	(自 C++11 起)

异常

抛出当前安装的 std::unexpected_handler 抛出的任何异常。

缺陷报告

以下行为更改的缺陷报告已追溯应用于以前发布的 C++ 标准。

DR	应用于	已发布的行为	正确行为
LWG 2111	C++11	在堆栈期间调用 std::set_unexpected 的效果 展开与 C++98 不同，并且破坏了一些 ABI	未指定

另请参见

unexpected (C++23)	表示为意外值 (类模板)
unexpected_handler (在 C++11 中弃用)(在 C++17 中移除)	由 std::unexpected 调用的函数的类型 (typedef)