std::promise<R>::set_value
来自cppreference.com
主模板 | ||
void set_value(const R& value ); | (1) | (C++11 起) |
void set_value( R&& value ); | (2) | (C++11 起) |
std::promise<R&> 特化 | ||
void set_value( R& value ); | (3) | (C++11 起) |
std::promise<void> 特化 | ||
void set_value(); | (4) | (C++11 起) |
1-3) 原子地存储 value 到共享状态，并使状态就绪。
4) 使状态就绪。
set_value、set_exception、set_value_at_thread_exit 和 set_exception_at_thread_exit 的操作表现类似。在更新承诺体对象时获得与该承诺体对象关联的一个互斥体。
对此函数的调用和对 get_future 的调用之间不会造成数据竞争（因此它们不需要彼此同步）。
目录 |
[编辑]参数
| value | - | 要在共享状态存储的值 |
[编辑]返回值
（无）
[编辑]异常
遇到下列条件时抛出 std::future_error：
- *this 无共享状态。设置错误码为 no_state。
- 共享状态已存储值或异常。设置错误码为 promise_already_satisfied。
另外还会抛出以下异常：
1) 被选中以复制
R 类型的对象的构造函数抛出的任何异常。2) 被选中以移动
R 类型的对象的构造函数抛出的任何异常。[编辑]示例
展示如何将 std::promise<void> 用于在线程间发信号。
运行此代码
#include <algorithm>#include <cctype>#include <chrono>#include <future>#include <iostream>#include <iterator>#include <sstream>#include <thread>#include <vector> usingnamespace std::chrono_literals; int main(){std::istringstream iss_numbers{"3 4 1 42 23 -23 93 2 -289 93"};std::istringstream iss_letters{" a 23 b,e a2 k k?a;si,ksa c"}; std::vector<int> numbers;std::vector<char> letters;std::promise<void> numbers_promise, letters_promise; auto numbers_ready = numbers_promise.get_future();auto letter_ready = letters_promise.get_future(); std::thread value_reader([&]{// 输入/输出操作std::copy(std::istream_iterator<int>{iss_numbers}, std::istream_iterator<int>{}, std::back_inserter(numbers)); // 为数字发出通知 numbers_promise.set_value(); std::copy_if(std::istreambuf_iterator<char>{iss_letters}, std::istreambuf_iterator<char>{}, std::back_inserter(letters), ::isalpha); // 为字母发出通知 letters_promise.set_value();}); numbers_ready.wait(); std::sort(numbers.begin(), numbers.end()); if(letter_ready.wait_for(1s)==std::future_status::timeout){// 在获取字母的同时输出数字for(int num : numbers)std::cout<< num <<' '; numbers.clear();// 数字已打印完成} letter_ready.wait();std::sort(letters.begin(), letters.end()); // 已打印数字的情况下什么也不做for(int num : numbers)std::cout<< num <<' ';std::cout<<'\n'; for(char let : letters)std::cout<< let <<' ';std::cout<<'\n'; value_reader.join();}
输出：
-289 -23 1 2 3 4 23 42 93 93 a a a a b c e i k k k s s
[编辑]缺陷报告
下列更改行为的缺陷报告追溯地应用于以前出版的 C++ 标准。
| 缺陷报告 | 应用于 | 出版时的行为 | 正确行为 |
|---|---|---|---|
| LWG 2098 | C++11 | 重载 (1,2) 分别只能抛出由 R 的复制/移动构造函数抛出的异常 | 它们可以抛出复制/移动 R 类型对象选择的构造函数抛出的异常 |
[编辑]参阅
| 设置结果为指定值，同时仅在线程退出时分发提醒 (公开成员函数) | |
| 设置结果为指示异常 (公开成员函数) |
