命名空间
变体
操作

std::promise<R>::set_value_at_thread_exit

来自 cppreference.cn
< cpp‎ | thread‎ | promise
 
C++
 
并发支持库
线程
(C++11)
(C++20)
(C++17)(C++17)
this_thread 命名空间
(C++11)
(C++11)
(C++11)
(C++11)
协同取消
互斥
(C++11)
(C++11)
(C++17)
通用锁管理
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(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++20)
(C++20)
期值
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
(C++26)
(C++26)
危险指针
(C++26)
(C++26)
(C++26)
原子类型
(C++11)
(C++20)
(C++11)
原子类型的初始化
(C++11)(C++20 中已弃用)
(C++11)(C++20 中已弃用)
(C++11)
内存排序
(C++11)
(C++11)(C++26 中已弃用)
(C++11)
(C++11)
原子操作的自由函数
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++11)(C++11)
(C++26)(C++26)
(C++26)(C++26)
(C++11)
(C++20)(C++20)
(C++20)
(C++20)
原子标志的自由函数
(C++11)(C++11)
(C++11)(C++11)
(C++20)(C++20)
(C++20)(C++20)
(C++20)
(C++20)
 
std::promise
 
主模板
void set_value_at_thread_exit( const R& value );
 (1) (C++11 起)
void set_value_at_thread_exit( R&& value );
 (2) (C++11 起)
std::promise<R&> 特化
void set_value_at_thread_exit( R& value );
 (3) (C++11 起)
std::promise<void> 特化
void set_value_at_thread_exit();
 (4) (C++11 起)

存储 value 到共享状态，但不会立即使状态就绪。状态将在当前线程退出时（在所有具有线程局部存储期的变量被销毁后）就绪。

该操作的行为如同 set_value、set_exception、set_value_at_thread_exit 和 set_exception_at_thread_exit 在更新 promise 对象时获取与该 promise 对象关联的单个互斥体。

此函数的调用不会与对 get_future 的调用引入数据竞争（因此它们之间不需要同步）。

目录

[编辑] 参数

value - 要存储到共享状态的值

[编辑] 返回值

(无)

[编辑] 异常

在以下条件下抛出 std::future_error：

此外，

1) 复制类型为 R 的对象所选用的构造函数抛出的任何异常。
2) 移动类型为 R 的对象所选用的构造函数抛出的任何异常。

[编辑] 示例

运行此代码
#include <future>
#include <iostream>
#include <thread>
 
int main()
{
    using namespace std::chrono_literals;
    std::promise<int> p;
    std::future<int> f = p.get_future();
    std::thread([&p]
    {
        std::this_thread::sleep_for(1s);
        p.set_value_at_thread_exit(9);
    }).detach();
 
    std::cout << "Waiting... " << std::flush;
    f.wait();
    std::cout << "Done!\nResult is: " << f.get() << '\n';
}

输出

Waiting... Done!
Result is: 9

[编辑] 缺陷报告

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

缺陷报告 应用于 发布时的行为 正确的行为
LWG 2098 C++11 未明确应抛出哪些异常 已明确

[编辑] 参阅

 将结果设置为特定值
(public 成员函数) [编辑]
 将结果设置为指示异常，仅在线程退出时发送通知
(public 成员函数) [编辑]
取自 "https://cppreference.cn/mwiki/index.php?title=cpp/thread/promise/set_value_at_thread_exit&oldid=169934"