std::future<T>::wait_until
來自 cppreference.com
| 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 繫結的時鐘來測量時間；該時鐘不要求是單調時鐘。如果時鐘不連續調整，則此函式的行為不作保證，但現有實現將 Clock 中的 timeout_time 轉換為 std::chrono::system_clock 並委託給 POSIX pthread_cond_timedwait，以便等待遵守系統時鐘的調整，但不遵守使用者提供的 Clock。無論如何，由於排程或資源爭用延遲，該函式也可能等待超過 timeout_time 之後的時間。
[編輯] 示例
執行此程式碼
#include <chrono> #include <future> #include <iostream> #include <thread> int main() { std::chrono::system_clock::time_point two_seconds_passed = std::chrono::system_clock::now() + std::chrono::seconds(2); // Make a future that takes 1 second to complete std::promise<int> p1; std::future<int> f_completes = p1.get_future(); std::thread([](std::promise<int> p1) { std::this_thread::sleep_for(std::chrono::seconds(1)); p1.set_value_at_thread_exit(9); }, std::move(p1) ).detach(); // Make a future that takes 5 seconds to complete std::promise<int> p2; std::future<int> f_times_out = p2.get_future(); std::thread([](std::promise<int> p2) { std::this_thread::sleep_for(std::chrono::seconds(5)); p2.set_value_at_thread_exit(8); }, std::move(p2) ).detach(); std::cout << "Waiting for 2 seconds..." << std::endl; if (std::future_status::ready == f_completes.wait_until(two_seconds_passed)) std::cout << "f_completes: " << f_completes.get() << "\n"; else std::cout << "f_completes did not complete!\n"; if (std::future_status::ready == f_times_out.wait_until(two_seconds_passed)) std::cout << "f_times_out: " << f_times_out.get() << "\n"; else std::cout << "f_times_out did not complete!\n"; std::cout << "Done!\n"; }
可能的輸出
Waiting for 2 seconds... f_completes: 9 f_times_out did not complete! Done!
[編輯] 另請參閱
| 等待結果可用 (公共成員函式) | |
| 等待結果，如果在指定的超時時間內不可用則返回 (公共成員函式) |
