std::unexpected

 

C++

编译器支持

自立实现与有宿主实现

语言

标准库

标准库标头

具名要求

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

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

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

并发支持库 (C++11)

技术规范

符号索引

外部库

 

诊断库

异常处理 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++11)(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 中移除)

std::unexpected() 为 C++ 运行时在违背动态异常规定时调用：从其异常规定禁止此类型异常的函数抛出该类型异常。

亦可从程序直接调用 std::unexpected() 。

任一情况下， std::unexpected 调用当前安装的 std::unexpected_handler 。默认的 std::unexpected_handler 调用 std::terminate 。

若析构函数在栈回溯期间重置 unexpected_handler 且之后的回溯导致调用 unexpected ，则将调用于 throw 表达式结尾安装的处理函数。（注意：重抛出是否应用新的处理函数是有歧义的）	(C++11 前)
若析构函数在栈回溯期间重置 unexpected_handler ，则若之后的回溯导致调用 unexpected ，则调用哪个处理函数是未指定的。	(C++11 起)

参数

（无）

返回值

（无）

异常

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

缺陷报告

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

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

参阅

unexpected_handler (C++17 中移除)

std::unexpected 所调用的函数类型 (typedef)