promise::set_value メソッド
アトミックに値をこの promise オブジェクトの結果として格納し、関連付けられた非同期状態を準備完了に設定します。
void promise::set_value(const Ty& Val);
void promise::set_value(Ty&& Val);
void promise<Ty&>::set_value(Ty& Val);
void promise<void>::set_value();
パラメーター
- Val
結果として格納される値。
解説
promise オブジェクトが関連付けられた非同期状態ではない場合、このメソッドは no_state のエラー コードを持つ future_error をスローします。
set_exception、set_exception_at_thread_exit、set_value、または set_value_at_thread_exit が同じ関連付けられた非同期状態の promise オブジェクトに対して呼び出されている場合、このメソッドは promise_already_satisfied のエラー コードを持つ future_error をスローします。
このメソッドの結果として、関連付けられた非同期状態に対してブロックされているすべてのスレッドのブロックが解除されます。
最初のメソッドは、Val が関連付けられた非同期状態にコピーされたときにスローされるすべての例外もスローします。 この状況では、関連付けられた非同期状態は準備完了に設定されません。
2 番目のメソッドは、Val が関連付けられた非同期状態に移動されたときにスローされるすべての例外もスローします。 この状況では、関連付けられた非同期状態は準備完了に設定されません。
部分的特殊化 promise<Ty&> の場合、格納されている値は、実際には Val への参照です。
特殊化 promise<void> の場合、格納されている値は存在しません。
必要条件
ヘッダー: future
名前空間: std