std::shared_future<T>::wait_until
來自 cppreference.com
< cpp | thread | shared_future
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_state 的 std::future_error。
標準建議使用與 timeout_time 繫結的時鐘來測量時間;該時鐘不要求是單調時鐘。如果時鐘不連續調整,則此函式的行為沒有保證,但現有實現將 timeout_time 從 Clock
轉換為 std::chrono::system_clock 並委託給 POSIX pthread_cond_timedwait
,以便等待遵守系統時鐘的調整,但不遵守使用者提供的 Clock
。無論如何,由於排程或資源爭用延遲,該函式也可能等待超過 timeout_time 所達到的時間。
[編輯] 示例
本節不完整 原因:無示例 |
[編輯] 另請參閱
等待結果可用 (public member function) | |
等待結果,如果在指定的超時時間內不可用則返回 (public member function) |