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ターゲット（関数、ラムダ式、bind式、または他の関数オブジェクト）をラップし、非同期に呼び出せるようにします。その戻り値またはスローされた例外は共有状態に格納され、std::futureオブジェクトを通じてアクセスできます。

std::functionと同様に、std::packaged_taskはポリモーフィックでアロケータ対応のコンテナです。格納された呼び出し可能ターゲットは、ヒープまたは提供されたアロケータで割り当てられる場合があります。

(C++17まで)

(コンストラクタ)	タスクオブジェクトを構築する (public member function) [編集]
(デストラクタ)	タスクオブジェクトを破棄します (public member function) [編集]
operator=	タスクオブジェクトを移動します (public member function) [編集]
valid	タスクオブジェクトが有効な関数を持っているかどうかを確認します (public member function) [編集]
swap	2つのタスクオブジェクトを交換します (public member function) [編集]
結果の取得
get_future	約束された結果に関連付けられたstd::futureを返します (public member function) [編集]
実行
operator()	関数を実行する (public member function) [編集]
make_ready_at_thread_exit	現在のスレッドが終了するまで結果を準備しない関数を実行します。 (public member function) [編集]
reset	状態をリセットし、以前の実行結果をすべて破棄します (public member function) [編集]

[編集] 非メンバ関数

std::swap(std::packaged_task)

(C++11)

std::swap アルゴリズムを特殊化する
(関数テンプレート) [編集]

[編集] ヘルパークラス

std::uses_allocator<std::packaged_task>

(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++標準に遡って適用されました。

DR	適用対象	公開された動作	正しい動作
LWG 3117	C++17	`packaged_task`の推論ガイドが欠落していました	追加された

[編集] 関連項目

future

(C++11)

非同期に設定される値を待機する
(クラステンプレート) [編集]

コンパイラサポート
フリースタンディングとホスト
言語
標準ライブラリ
標準ライブラリヘッダー
名前付き要件
機能テストマクロ (C++20)
言語サポートライブラリ
コンセプトライブラリ (C++20)
診断ライブラリ
メモリ管理ライブラリ
メタプログラミングライブラリ (C++11)
汎用ユーティリティライブラリ
コンテナライブラリ
イテレータライブラリ
Rangesライブラリ (C++20)
アルゴリズムライブラリ
文字列ライブラリ
テキスト処理ライブラリ
数値ライブラリ
日付と時刻ライブラリ
入出力ライブラリ
ファイルシステムライブラリ (C++17)
並行サポートライブラリ (C++11)
実行制御ライブラリ (C++26)
Technical specifications (技術仕様)
シンボルインデックス
外部ライブラリ

メンバ関数
packaged_task::packaged_task
packaged_task::~packaged_task
packaged_task::operator=
packaged_task::valid
packaged_task::swap
結果の取得
packaged_task::get_future
実行
packaged_task::operator()
packaged_task::make_ready_at_thread_exit
packaged_task::reset
非メンバ関数
swap(std::packaged_task)
ヘルパークラス
uses_allocator<std::packaged_task> (C++17まで)
推論ガイド(C++17)

cppreference.com

名前空間

変種

表示

操作

std::packaged_task

目次

[編集] メンバ関数

結果の取得

実行