std::promise<R>:: get_future

std:: future < R > get_future ( ) ;		(C++11以降)

このオブジェクトと同じ共有状態に関連付けられたfutureオブジェクトを返します。 * this 。

共有状態を持たない場合、または get_future が既に呼び出されている場合、例外がスローされます。プロミス-フューチャ通信チャネルの複数の「ポップ」エンドを取得するには、 std::future::share を使用してください。

この関数の呼び出しは、 set_value 、 set_exception 、 set_value_at_thread_exit または set_exception_at_thread_exit の呼び出しとの間でデータ競合を引き起こしません（したがって、これらは互いに同期を取る必要はありません）。

パラメータ

(なし)

戻り値

この共有状態を参照するfuture。 * this .

例外

std::future_error が以下の条件で発生します：

• * this は共有状態を持ちません。エラーコードは no_state に設定されています。

• get_future() は、同じ共有状態を持つpromiseに対して既に呼び出されています。 エラーコードは future_already_retrieved に設定されます。