std::shared_future<T>::wait_for
來自 cppreference.com
< cpp | thread | shared_future
| template< class Rep, class Period > std::future_status wait_for( const std::chrono::duration<Rep,Period>& timeout_duration ) const; |
(C++11 起) | |
等待結果可用。阻塞直到指定的 timeout_duration 已過或結果可用，以先發生者為準。返回值標識結果的狀態。
如果 future 是透過使用延遲評估呼叫 std::async 的結果，此函式會立即返回而不等待。
由於排程或資源競爭延遲，此函式可能會阻塞超過 timeout_duration 的時間。
標準建議使用穩定時鐘來測量持續時間。如果實現使用系統時鐘，則等待時間也可能對時鐘調整敏感。
在呼叫此函式之前，如果 valid() 為 false，則行為未定義。
目錄 |
[edit] 引數
| timeout_duration | - | 最大阻塞持續時間 |
[edit] 返回值
| 常量 | 解釋 |
| future_status::deferred | 共享狀態包含使用延遲評估的延遲函式，因此只有在明確請求時才會計算結果 |
| future_status::ready | 結果已就緒 |
| future_status::timeout | 超時已過期 |
[edit] 異常
在執行過程中，時鐘 (clock)、時間點 (time_point) 或持續時間 (duration) 丟擲的任何異常（標準庫提供的時鐘、時間點和持續時間永遠不會丟擲異常）。
[edit] 注意
鼓勵實現檢測在呼叫前 valid == false 的情況，並丟擲帶有錯誤條件 std::future_errc::no_state 的 std::future_error。
[edit] 示例
執行此程式碼
#include <chrono> #include <future> #include <iostream> #include <thread> using namespace std::chrono_literals; int main() { std::shared_future<int> future = std::async(std::launch::async, []() { std::this_thread::sleep_for(3s); return 8; }); std::cout << "waiting...\n"; std::future_status status; do { switch (status = future.wait_for(1s); status) { case std::future_status::deferred: std::cout << "deferred\n"; break; case std::future_status::timeout: std::cout << "timeout\n"; break; case std::future_status::ready: std::cout << "ready!\n"; break; } } while (status != std::future_status::ready); std::cout << "result is " << future.get() << '\n'; }
可能的輸出
waiting... timeout timeout timeout ready! result is 8
[edit] 另請參閱
| 等待結果可用 (公共成員函式) | |
| 等待結果，如果到指定時間點仍不可用則返回 (公共成員函式) |
