BloombergLP::bslmt::ThreadUtilImpl<Platform::PosixThreads>::sleepUntil

Suspend the current thread until the specified absolute time.

Synopsis

Declared in <bslmt_threadutilimpl_pthread.h>

static
int
sleepUntil(
    bsls::TimeInterval const& absoluteTime,
    bsls::SystemClockType::Enum clockType = bsls::SystemClockType::e_REALTIME);

Description

Suspend execution of the current thread until the specified absoluteTime. Optionally specify clockType which determines the epoch from which the interval absoluteTime is measured (see {Supported Clock-Types} in the component documentation). Return 0 on success, and a non-zero value otherwise. The behavior is undefined unless absoluteTime represents a time after January 1, 1970 and before the end of December 31, 9999 (i.e., a time interval greater than or equal to 0, and less than 253,402,300,800 seconds). Note that the actual time suspended depends on many factors including system scheduling and system timer resolution.

Return Value

0 on success, and a non-zero value otherwise

Parameters

NameDescription
absoluteTimeabsolute time at which to resume
clockTypeclock epoch used to interpret absoluteTime