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

См. также