std::shared_future<T>::wait_until

template< class Clock, class Duration >
std::future_status wait_until( const std::chrono::time_point<Clock,Duration>& timeout_time ) const;

wait_until ожидает, пока результат станет доступным. Он блокируется до тех пор, пока не будет достигнута указанная timeout_time, или результат станет доступным, в зависимости от того, что произойдёт раньше. Значение возвращаемого значения указывает причину, по которой wait_until вернулось.

Если будущее является результатом вызова async с использованием ленивой оценки, эта функция возвращается немедленно без ожидания.

Поведение не определено, если valid() является false до вызова этой функции, или Clock не удовлетворяет требованиям Clock. Программа некорректна, если std::chrono::is_clock_v<Clock> является false.(с C++20)

Параметры

Возвращаемое значение

Исключения

Любое исключение, сгенерированное часами, временными точками или продолжительностью во время выполнения (часы, временные точки и продолжительности, предоставляемые стандартной библиотекой, никогда не генерируют исключения).

Примечания

Реализации рекомендуются определять случай, когда valid() == false перед вызовом и генерировать std::future_error с условием ошибки future_errc::no_state.

Стандарт рекомендует использовать часы, связанные с timeout_time, для измерения времени; эти часы не обязаны быть монотонными. Нет гарантий относительно поведения этой функции, если часы изменяются прерывисто, но существующие реализации преобразуют timeout_time из Clock в std::chrono::system_clock и делегируют вызов POSIX pthread_cond_timedwait, чтобы ожидание учитывало изменения системных часов, но не пользовательских часов Clock. В любом случае, функция также может ждать дольше, чем до момента достижения timeout_time, из-за задержек планирования или конкуренции за ресурсы.

Пример

См. также