just::thread Complete C++ Standard Thread Library by Just Software Solutions

lock.owns_lock() is true, and the lock is owned by the calling thread.

Atomically unlock the supplied lock object and block until the the thread is woken by a call to notify_one() or notify_all() by another thread, or the time period specified by relative_time has elapsed or the thread is woken spuriously. The lock object is locked again before the call to wait_for() returns.

std::cv_status::no_timeout if the thread was woken by a call to notify_one() or notify_all() or a spurious wake-up, std::cv_status::timeout otherwise.

std::system_error if the effects cannot be achieved. If the lock object is unlocked during the call to wait_for(), it is locked again on exit, even if the function exits via an exception.

The spurious wake ups mean that a thread calling wait_for() may wake even though no thread has called notify_one() or notify_all(). It is therefore recommended that the overload of wait_for() that takes a predicate is used in preference where possible. Otherwise, it is recommended that wait_for() be called in a loop which tests the predicate associated with the condition variable. Care must be taken when doing this to ensure that the timeout is still valid; wait_until() may be more appropriate in many circumstances. The thread may be blocked for longer than the specified duration. Where possible, the elapsed time is determined by a monotonic clock.

Calls to notify_one(), notify_all(), wait(), wait_for() and wait_until() on a single std::condition_variable instance are serialized. A call to notify_one() or notify_all() will only wake threads that started waiting prior to that call.