std::packaged_task

 

C++

言語

標準ライブラリヘッダ

フリースタンディング処理系とホスト処理系

名前付き要件

言語サポートライブラリ

コンセプトライブラリ(C++20)

診断ライブラリ

ユーティリティライブラリ

文字列ライブラリ

コンテナライブラリ

イテレータライブラリ

範囲ライブラリ(C++20)

アルゴリズムライブラリ

数値演算ライブラリ

ローカライゼーションライブラリ

入出力ライブラリ

ファイルシステムライブラリ(C++17)

正規表現ライブラリ(C++11)

アトミック操作ライブラリ(C++11)

スレッドサポートライブラリ(C++11)

技術仕様書

 

スレッドサポートライブラリ

スレッド
thread (C++11)
jthread (C++20)
stop_token (C++20)
stop_source (C++20)
stop_callback (C++20)
hardware_destructive_interference_sizehardware_constructive_interference_size (C++17)(C++17)
this_thread 名前空間
get_id (C++11) yield (C++11)	sleep_for (C++11) sleep_until (C++11)
相互排他
mutex (C++11) recursive_mutex (C++11) shared_mutex (C++17)	timed_mutex (C++11) recursive_timed_mutex (C++11) shared_timed_mutex (C++14)
汎用ロック管理
lock_guard (C++11) scoped_lock (C++17) unique_lock (C++11) shared_lock (C++14) defer_lock_ttry_to_lock_tadopt_lock_t (C++11)(C++11)(C++11)	lock (C++11) try_lock (C++11) defer_locktry_to_lockadopt_lock (C++11)(C++11)(C++11) once_flag (C++11) call_once (C++11)
条件変数
condition_variable (C++11)
condition_variable_any (C++11)
notify_all_at_thread_exit (C++11)
cv_status (C++11)
セマフォ
counting_semaphorebinary_semaphore (C++20)(C++20)
ラッチとバリア
latch (C++20)
barrier (C++20)
フューチャー
promise (C++11) future (C++11) shared_future (C++11) packaged_task (C++11) async (C++11)	launch (C++11) future_status (C++11) future_error (C++11) future_category (C++11) future_errc (C++11)

 

std::packaged_task

メンバ関数

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

 

ヘッダ <future> で定義
template<class>class packaged_task;//not defined	(1)	(C++11以上)
template<class R, class ...Args> class packaged_task<R(Args...)>;	(2)	(C++11以上)

クラステンプレート std::packaged_task は、任意の Callable なターゲット (関数、ラムダ式、バインド式、または別の関数オブジェクト) を、非同期に呼ぶことができるようにラップします。 その戻り値または投げられた例外は、 std::future オブジェクトを通してアクセスできる共有状態に格納されます。

std::function と同様、 std::packaged_task は多相的で、アロケータ対応のコンテナです。 格納された callable なターゲットはヒープに、または提供されたアロケータを使用して確保することができます。

(C++17未満)

メンバ関数

コンストラクタ	タスクオブジェクトを構築します (パブリックメンバ関数)
デストラクタ	タスクオブジェクトを破棄します (パブリックメンバ関数)
operator=	タスクオブジェクトをムーブします (パブリックメンバ関数)
valid	タスクオブジェクトが有効な関数を持っているか調べます (パブリックメンバ関数)
swap	2つのタスクオブジェクトを入れ替えます (パブリックメンバ関数)
結果の取得
get_future	約束された結果に紐付けられた std::future を返します (パブリックメンバ関数)
実行
operator()	関数を実行します (パブリックメンバ関数)
make_ready_at_thread_exit	関数を実行し、カレントスレッドの終了後にのみ結果が準備完了になるようにします (パブリックメンバ関数)
reset	格納されている以前の実行の結果をすべて破棄し、状態をリセットします (パブリックメンバ関数)

非メンバ関数

std::swap(std::packaged_task) (C++11)

std::swap アルゴリズムの特殊化 (関数テンプレート)

ヘルパークラス

std::uses_allocator<std::packaged_task> (C++11)(C++17未満)

std::uses_allocator 型特性の特殊化 (クラステンプレートの特殊化)

例

Run this code

#include <iostream>#include <cmath>#include <thread>#include <future>#include <functional>   // std::pow オーバーロード集合の曖昧性解消を回避するための一意な関数int f(int x, int y){returnstd::pow(x,y);}   void task_lambda(){ std::packaged_task<int(int,int)> task([](int a, int b){returnstd::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

関連項目

future (C++11)

非同期に設定される値を待ちます (クラステンプレート)