std::exception_ptr

< cpp‎ | error
 
C++
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
(C++14)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++20)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++17)
(C++17)

初等字符串转换
(C++17)
(C++17)
(C++17)
 
错误处理
异常处理
(C++20 前)(C++17)
exception_ptr
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
异常处理失败
(C++11)
(C++17 前)
(C++17 前)
(C++11)(C++17 前)
(C++17 前)
错误号
错误号
 
定义于头文件 <exception>
typedef /*unspecified*/ exception_ptr;
 (C++11 起)

std::exception_ptr 是一个类可空指针的类型，管理已抛出并为 std::current_exception 所捕捉的异常对象。 std::exception_ptr 的实例可传递给另一函数，可以在另一线程，在那里异常可能重抛并为 catch 子句所处理。

默认构造的 std::exception_ptr 是空指针；它不指向异常对象。

二个 std::exception_ptr 实例比较相等，仅若它们均为空或都指向同一异常对象。

std::exception_ptr 不可隐式转换为任何算术、枚举或指针类型。它可以按语境转换成 bool ，且若它为空则求值为 false ，否则为 true 。

一个 std::exception_ptr 所引用的异常对象只要为至少一个 std::exception_ptr 所引用就保持合法： std::exception_ptr 是共享所有权的智能指针（注意：这附加于异常对象生存期规则）

std::exception_ptr 满足可空指针 (NullablePointer) 的要求。

示例

运行此代码
#include <iostream>
#include <string>
#include <exception>
#include <stdexcept>
 
void handle_eptr(std::exception_ptr eptr) // 按值传递 ok
{
    try {
        if (eptr) {
            std::rethrow_exception(eptr);
        }
    } catch(const std::exception& e) {
        std::cout << "Caught exception \"" << e.what() << "\"\n";
    }
}
 
int main()
{
    std::exception_ptr eptr;
    try {
        std::string().at(1); // 这生成一个 std::out_of_range
    } catch(...) {
        eptr = std::current_exception(); // 捕获
    }
    handle_eptr(eptr);
} // std::out_of_range 的析构函数调用于此，在 ept 析构时

输出： 

Caught exception "basic_string::at"

参阅

(C++11)
 从异常对象创建一个std::exception_ptr
(函数模板)
(C++11)
 捕获当前异常到 std::exception_ptr 之中
(函数)
(C++11)
 从一个 std::exception_ptr 抛出异常
(函数)