Namespaces
Variants
Actions

std::this_thread::sleep_until

From cppreference.com
< cpp‎ | thread
 
 
Concurrency support library
(C++11)
(C++20)
(C++11)
(C++11)
(C++11)
sleep_until
(C++11)
(C++11)
(C++17)
(C++11)
(C++11)
(C++17)
(C++11)
(C++14)
(C++11)
(C++11)
(C++11)
(C++11)
(C++20)
(C++20)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++11)
(C++26)
(C++26)
(C++26)
(C++26)
(C++11)
(C++20)
(C++11)
(C++11)(deprecated in C++20)
(C++11)(deprecated in C++20)
(C++11)
(C++11)(deprecated in C++26)
 
Defined in header <thread>
template< class Clock, class Duration >
void sleep_until( const std::chrono::time_point <Clock, Duration>& sleep_time );
(since C++11)

Blocks the execution of the current thread until specified sleep_time has been reached.

Clock must meet the Clock requirements. The program is ill-formed if std::chrono::is_clock_v <Clock> is false.(since C++20)

The standard recommends that the clock tied to sleep_time be used, in which case adjustments of the clock may be taken into account. Thus, the duration of the block might be more or less than sleep_time - Clock::now() at the time of the call, depending on the direction of the adjustment and whether it is honored by the implementation. The function also may block until after sleep_time has been reached due to process scheduling or resource contention delays.

[edit] Parameters

sleep_time - time to block until

[edit] Return value

(none)

[edit] Exceptions

Any exception thrown by Clock or Duration (clocks and durations provided by the standard library never throw).

[edit] Example

Run this code
#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";
}

Possible output:

Hello, waiter...
Waited 2000.17 ms

[edit] See also

(C++11)
stops the execution of the current thread for a specified time duration
(function) [edit]
C documentation for thrd_sleep
Retrieved from "https://en.cppreference.com/mwiki/index.php?title=cpp/thread/sleep_until&oldid=161243"

AltStyle によって変換されたページ (->オリジナル) /