名稱空間
變體
操作

std::promise<R>::set_value_at_thread_exit

來自 cppreference.com
< 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.tw/mwiki/index.php?title=cpp/thread/promise/set_value_at_thread_exit&oldid=169934"