命名空间
变体
操作

std::promise<R>::set_exception

来自 cppreference.com
< cpp‎ | thread‎ | promise
 
 
并发支持库
线程
(C++11)
(C++20)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
协作式取消
互斥
(C++11)
通用锁管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
条件变量
(C++11)
信号量
闩锁和屏障
(C++20)
(C++20)
期货
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
危险指针
原子类型
(C++11)
(C++20)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
内存排序
原子操作的自由函数
原子标志的自由函数
 
 
void set_exception( std::exception_ptr p );
(自 C++11 起)

将异常指针 p 原子地存储到共享状态中,并使该状态变为就绪状态。

该操作的行为就好像 set_valueset_exceptionset_value_at_thread_exitset_exception_at_thread_exit 在更新 promise 对象时获取与 promise 对象关联的单个互斥锁。

如果不存在共享状态或共享状态已存储值或异常,则会抛出异常。

对该函数的调用不会对对 get_future 的调用引入数据竞争(因此它们不需要相互同步)。

内容

[编辑] 参数

p - 要存储的异常指针。如果 p 为空,则行为未定义

[编辑] 返回值

(无)

[编辑] 异常

在以下情况下抛出 std::future_error

  • *this 没有共享状态。错误代码设置为 no_state

[编辑] 示例

#include <future>
#include <iostream>
#include <thread>
 
int main()
{
    std::promise<int> p;
    std::future<int> f = p.get_future();
 
    std::thread t([&p]
    {
        try
        {
            // code that may throw
            throw std::runtime_error("Example");
        }
        catch (...)
        {
            try
            {
                // store anything thrown in the promise
                p.set_exception(std::current_exception());
                // or throw a custom exception instead
                // p.set_exception(std::make_exception_ptr(MyException("mine")));
            }
            catch (...) {} // set_exception() may throw too
        }
    });
 
    try
    {
        std::cout << f.get();
    }
    catch (const std::exception& e)
    {
        std::cout << "Exception from the thread: " << e.what() << '\n';
    }
    t.join();
}

输出

Exception from the thread: Example

[编辑] 另请参见

将结果设置为指示异常,同时仅在线程退出时传递通知
(公共成员函数) [编辑]