名稱空間
變體
操作

std::packaged_task

來自 cppreference.com
< cpp‎ | thread
 
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)
packaged_task
(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::packaged_task
 
在標頭檔案 <future> 中定義
template< class >
class packaged_task;
 (1) (C++11 起)
(未定義)
template< class R, class ...ArgTypes >
class packaged_task<R(ArgTypes...)>;
 (2) (C++11 起)

類模板 std::packaged_task 封裝了任何可呼叫 (Callable) 目標（函式、lambda 表示式、bind 表示式或其他函式物件），使其可以非同步呼叫。其返回值或丟擲的異常儲存在一個共享狀態中，該狀態可以透過 std::future 物件訪問。

與 std::function 類似，std::packaged_task 是一個多型的、感知分配器的容器：儲存的可呼叫目標可以分配在堆上，或者使用提供的分配器分配。

 (C++17 前)

目錄

[編輯] 成員函式

 構造任務物件
(public member function) [編輯]
 銷燬任務物件
(public member function) [編輯]
 移動任務物件
(public member function) [編輯]
 檢查任務物件是否有有效函式
(public member function) [編輯]
 交換兩個任務物件
(public member function) [編輯]
Getting the result
 返回與承諾結果關聯的 std::future
(public member function) [編輯]
執行
 執行函式
(public member function) [編輯]
 執行函式，確保僅在當前執行緒退出後結果才就緒
(public member function) [編輯]
 重置狀態，放棄之前執行的任何儲存結果
(public member function) [編輯]

[編輯] 非成員函式

(C++11)
 特化 std::swap 演算法
(函式模板) [編輯]

[編輯] 輔助類

(C++11) (直到 C++17)
 特化 std::uses_allocator 型別特性
(類模板特化) [編輯]

[編輯] 推導指南 (C++17 起)

[編輯] 示例

執行此程式碼
#include <cmath>
#include <functional>
#include <future>
#include <iostream>
#include <thread>
 
// unique function to avoid disambiguating the std::pow overload set
int f(int x, int y) { return std::pow(x, y); }
 
void task_lambda()
{
    std::packaged_task<int(int, int)> task([](int a, int b)
    {
        return std::pow(a, b); 
    });
    std::future<int> result = task.get_future();
 
    task(2, 9);
 
    std::cout << "task_lambda:\t" << result.get() << '\n';
}
 
void task_bind()
{
    std::packaged_task<int()> task(std::bind(f, 2, 11));
    std::future<int> result = task.get_future();
 
    task();
 
    std::cout << "task_bind:\t" << result.get() << '\n';
}
 
void task_thread()
{
    std::packaged_task<int(int, int)> task(f);
    std::future<int> result = task.get_future();
 
    std::thread task_td(std::move(task), 2, 10);
    task_td.join();
 
    std::cout << "task_thread:\t" << result.get() << '\n';
}
 
int main()
{
    task_lambda();
    task_bind();
    task_thread();
}

輸出

task_lambda: 512
task_bind:   2048
task_thread: 1024

[編輯] 缺陷報告

下列更改行為的缺陷報告追溯地應用於以前出版的 C++ 標準。

缺陷報告 應用於 釋出時的行為 正確的行為
LWG 3117 C++17 缺少 packaged_task 的推導指南 已新增

[編輯] 參閱

(C++11)
 等待一個非同步設定的值
(類模板) [編輯]
取自 "https://cppreference.tw/mwiki/index.php?title=cpp/thread/packaged_task&oldid=180411"