名稱空間
變體
操作

std::shared_future<T>::wait_until

來自 cppreference.com
 
 
併發支援庫
執行緒
(C++11)
(C++20)
this_thread 名稱空間
(C++11)
(C++11)
(C++11)
協同取消
互斥
(C++11)
通用鎖管理
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
條件變數
(C++11)
訊號量
門閂和屏障
(C++20)
(C++20)
期值
(C++11)
(C++11)
(C++11)
(C++11)
安全回收
(C++26)
危險指標
原子型別
(C++11)
(C++20)
原子型別的初始化
(C++11)(C++20 中已棄用)
(C++11)(C++20 中已棄用)
記憶體排序
(C++11)(C++26 中已棄用)
原子操作的自由函式
原子標誌的自由函式
 
 
template< class Clock, class Duration >
std::future_status wait_until( const std::chrono::time_point<Clock,Duration>& timeout_time ) const;
(C++11 起)

wait_until 等待結果可用。它會阻塞直到達到指定的 timeout_time 或結果可用,以先發生者為準。返回值指示 wait_until 返回的原因。

如果 future 是透過延遲求值呼叫 async 的結果,則此函式會立即返回而不會等待。

如果在呼叫此函式之前 valid()false,或者 Clock 不滿足 Clock 要求,則行為是未定義的。如果 std::chrono::is_clock_v<Clock>false,則程式格式錯誤。(從 C++20 開始)

目錄

[編輯] 引數

timeout_time - 最大阻塞時間點

[編輯] 返回值

常量 解釋
future_status::deferred 共享狀態包含使用延遲評估的延遲函式,因此只有在明確請求時才會計算結果
future_status::ready 結果已就緒
future_status::timeout 超時已過期

[編輯] 異常

在執行過程中,時鐘 (clock)、時間點 (time_point) 或持續時間 (duration) 丟擲的任何異常(標準庫提供的時鐘、時間點和持續時間永遠不會丟擲異常)。

[編輯] 注意

鼓勵實現檢測呼叫前 valid() == false 的情況,並丟擲帶有錯誤條件 future_errc::no_statestd::future_error

標準建議使用與 timeout_time 繫結的時鐘來測量時間;該時鐘不要求是單調時鐘。如果時鐘不連續調整,則此函式的行為沒有保證,但現有實現將 timeout_timeClock 轉換為 std::chrono::system_clock 並委託給 POSIX pthread_cond_timedwait,以便等待遵守系統時鐘的調整,但不遵守使用者提供的 Clock。無論如何,由於排程或資源爭用延遲,該函式也可能等待超過 timeout_time 所達到的時間。


[編輯] 示例

[編輯] 另請參閱

等待結果可用
(public member function) [編輯]
等待結果,如果在指定的超時時間內不可用則返回
(public member function) [編輯]