std::this_thread::sleep_until

template< class Clock, class Duration >
void sleep_until( const std::chrono::time_point<Clock, Duration>& sleep_time );

Блокирует выполнение текущей нити до тех пор, пока не будет достигнуто указанное sleep_time.

Clock должно удовлетворять требованиям Clock. Программа некорректна, если std::chrono::is_clock_v<Clock> является false. (с C++20)

Стандарт рекомендует использовать часы, связанные с sleep_time, в этом случае могут учитываться корректировки часов. Таким образом, продолжительность блока может быть больше или меньше, чем sleep_time - Clock::now() в момент вызова, в зависимости от направления корректировки и того, учитывается ли она реализацией. Функция также может заблокироваться до момента достижения sleep_time из-за задержек планирования процессов или конкуренции за ресурсы.

Параметры

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

(нет)

Исключения

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

Пример

#include <chrono>
#include <iostream>
#include <thread>
 
auto now() { return std::chrono::steady_clock::now(); }
 
auto awake_time()
{
    using std::chrono::operator""ms;
    return now() + 2000ms;
}
 
int main()
{
    std::cout << "Hello, waiter...\n" << std::flush;
    const auto start{now()};
    std::this_thread::sleep_until(awake_time());
    std::chrono::duration<double, std::milli> elapsed{now() - start};
    std::cout << "Waited " << elapsed.count() << " ms\n";
}

Hello, waiter...
Waited 2000.17 ms

См. также