Creates the Condition object.

Condition::constructor()

my Condition $cond();

Destroys the object.

delete $cond;

Creates a new Condition object, not based on the original.

my Condition $new_cond = $cond.copy();

Signals a single blocked thread to wake up. Normally this method call will be made while the same AbstractSmartLock object used for Condition::wait() calls is locked. Then, when the thread calling this method unlocks the AbstractSmartLock object, the thread(s) woken up by this call can continue executing.

nothing Condition::signal()

$cond.signal();

Wakes up all threads waiting on the Condition object. Normally this method call will be made while the same AbstractSmartLock object used for Condition::wait() calls is locked. Then, when the thread calling this method unlocks the AbstractSmartLock object, the thread(s) woken up by this call can continue executing.

nothing Condition::broadcast()

$cond.broadcast();

Blocks a thread on the Condition object. Must be called with an AbstractSmartLock argument, and the AbstractSmartLock must be locked before the call. This method will atomically unlock the AbstractSmartLock object and wait on this Condition object to be woken up with a Condition::signal() or Condition::broadcast() method call in another thread. At this point, the AbstractSmartLock will be reacquired with the same state as it was acquired previously before control returns to the blocked thread. The wait condition should always be tested again when the thread is unblocked.

Also accepts an optional timeout value in milliseconds. Like all Qore functions and methods taking timeout values, a relative time value may be passed instead of an integer to make the timeout units clear (ex: 2500ms for 2.5 seconds). Also if the call times out, the AbstractSmartLock will also be acquired when the Condition::wait() call returns and ETIMEDOUT will be returned.

int Condition::wait(AbstractSmartLock $lock, timeout $timeout_ms = 0)

{
    $mutex.lock();
    on_exit $mutex.unlock();
    while ($num > 0)
        $cond.wait($mutex);
    # ... do something
}

Returns the number of threads currently blocked on this object using the AbstractSmartLock passed; the AbstractSmartLock can be in any state (locked or unlocked) for this call (does not necessarily have to be locked).

int Condition::wait_count(AbstractSmartLock $lock)

$num_threads = $cond.wait_count();