命名空间
变体
操作

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++ 标准。

DR 应用于 已发布行为 正确行为
LWG 2098 C++11 不清楚需要抛出哪些异常 已明确

[编辑] 参见

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