completion_future 類別
表示對應至C++ AMP 異步操作的未來。
語法
class completion_future;
成員
公用建構函式
| 名稱 | 描述 |
|---|---|
| completion_future建構函式 | 初始化 completion_future 類別的新執行個體。 |
| ~completion_future解構函式 | completion_future終結物件。 |
公用方法
| 名稱 | 描述 |
|---|---|
| get | 等候相關聯的異步操作完成。 |
| then | 將回呼函式物件鏈結至 completion_future 相關聯的異步操作完成執行時所要執行的物件。 |
| to_task | 傳 task 回對應至相關聯異步操作的物件。 |
| 有效 | 取得布林值，該值會指出物件是否與非同步作業相關聯。 |
| 等 | 封鎖，直到相關聯的異步操作完成為止。 |
| wait_for | 封鎖，直到相關聯的異步操作完成或指定的 _Rel_time 時間已經過去為止。 |
| wait_until | 封鎖直到相關聯的異步操作完成，或直到目前時間超過 所指定的值為止 _Abs_time。 |
公用運算子
| 名稱 | 描述 |
|---|---|
| operator std：：shared_future<void> | 以隱含方式將 completion_future 物件 std::shared_future 轉換成物件。 |
| operator= | 將指定 completion_future 之物件的內容複製到這個物件中。 |
繼承階層架構
completion_future
需求
標頭： amprt.h
命名空間： concurrency
completion_future
初始化 completion_future 類別的新執行個體。
語法
completion_future();
completion_future(
const completion_future& _Other );
completion_future(
completion_future&& _Other );
參數
_其他
要 completion_future 複製或移動的物件。
多載清單
| 名稱 | 描述 |
|---|---|
completion_future(); |
初始化 類別的新實例completion_future |
completion_future(const completion_future& _Other); |
藉由複製建構函式，初始化 類別的新實例 completion_future 。 |
completion_future(completion_future&& _Other); |
藉由移動建構函式，初始化 類別的新實例 completion_future 。 |
get
等候相關聯的異步操作完成。 如果在異步操作期間遇到儲存的例外狀況，則擲回該例外狀況。
語法
void get() const;
operator std：：shared_future<void>
以隱含方式將 completion_future 物件 std::shared_future 轉換成物件。
語法
operator std::shared_future<void>() const;
傳回值
std::shared_future 物件。
operator=
將指定 completion_future 之物件的內容複製到這個物件中。
語法
completion_future& operator= (const completion_future& _Other );
completion_future& operator= (completion_future&& _Other );
參數
_其他
要從中複製的物件。
傳回值
這個 completion_future 對象的參考。
多載清單
| 名稱 | 描述 |
|---|---|
completion_future& operator=(const completion_future& _Other); |
使用深層複製，將指定 completion_future 物件的內容複製到這個物件中。 |
completion_future& operator=(completion_future&& _Other); |
使用移動指派，將指定 completion_future 物件的內容複製到這個物件中。 |
then
將回呼函式物件鏈結至 completion_future 相關聯的異步操作完成執行時所要執行的物件。
語法
template <typename _Functor>
void then(const _Functor & _Func ) const;
參數
_函
回呼函式。
_Func
回調函式物件。
to_task
傳 task 回對應至相關聯異步操作的物件。
語法
concurrency::task<void> to_task() const;
傳回值
task對應至相關聯異步操作的物件。
有效
取得布林值，該值會指出物件是否與非同步作業相關聯。
語法
bool valid() const;
傳回值
true 如果對象與異步操作相關聯，則為 ;否則為 false。
wait
封鎖，直到相關聯的異步操作完成為止。
語法
void wait() const;
wait_for
封鎖，直到相關聯的異步操作完成，或指定的 _Rel_time 時間已經過去。
語法
template <
class _Rep,
class _Period
>
std::future_status::future_status wait_for(
const std::chrono::duration< _Rep, _Period>& _Rel_time ) const;
參數
_代表
表示刻度數目的算術類型。
_時期
std：：ratio，表示每個刻度經過的秒數。
_Rel_time
等候作業完成的時間上限。
傳回值
傳回：
std::future_status::deferred如果相關聯的異步操作未執行，則為 。std::future_status::ready如果相關聯的異步操作已完成，則為 。std::future_status::timeout如果指定的時間週期已經過去，則為 。
wait_until
封鎖直到相關聯的異步操作完成，或直到目前時間超過 所指定的值為止 _Abs_time。
語法
template <
class _Clock,
class _Duration
>
std::future_status::future_status wait_until(
const std::chrono::time_point< _Clock, _Duration>& _Abs_time ) const;
參數
_時鐘
測量這個時間點的時鐘。
_期間
自 epoch 開始之後的 _Clock時間間隔，之後函式將會逾時。
_Abs_time
函式逾時的時間點。
傳回值
傳回：
std::future_status::deferred如果相關聯的異步操作未執行，則為 。std::future_status::ready如果相關聯的異步操作已完成，則為 。std::future_status::timeout如果指定的時間週期已經過去，則為 。
~completion_future
completion_future終結物件。
語法
~completion_future();