std::unexpected

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

功能特性测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

诊断库

异常处理 exception uncaught_exceptionuncaught_exceptions (until 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 (until C++17*) unexpected_handler (until C++17*) get_unexpected (until C++17*) set_unexpected (until 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，那么会调用在 throw 表达式结尾安装的处理函数。（注意：重抛出是否应用新的处理函数是有歧义的）	(C++11 前)
如果析构函数在栈回溯期间重置了非预期处理函数，那么之后的回溯导致调用 unexpected 时调用哪个处理函数是未指定的。	(C++11 起)

异常

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

缺陷报告

下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。

缺陷报告	应用于	出版时的行为	正确行为
LWG 2111	C++11	在栈回溯期间调用 std::set_unexpected 的效果与 C++98 不同，并破坏一些 ABI	令它未指定

参阅

unexpected (C++23)	表示一个非预期值 (类模板)
unexpected_handler (C++11 中弃用)(C++17 中移除)	std::unexpected 所调用的函数类型 (typedef)