Cond::wait

(PECL pthreads < 3.0.0)

Cond::wait — Wait for Condition

Warning

The Cond class has been removed in pthreads v3.

Description

final public static Cond::wait ( int $condition , int $mutex [, int $timeout ] ) : bool

Wait for a signal on a Condition Variable, optionally specifying a timeout to limit waiting time.

Parameters

condition: A handle returned by a previous call to Cond::create().
mutex: A handle returned by a previous call to Mutex::create() and owned (locked) by the caller.
timeout: An optional timeout, in microseconds ( millionths of a second ).

Return Values

A boolean indication of success.

Examples

Example #1 Waiting for Conditions


<?php
/** PLEASE NOTE THIS EXAMPLE WILL CAUSE THE PROCESS TO HANG **/
$mutex = Mutex::create(true);
/** You cannot use the "new" keyword, a Cond is not a PHP object **/
$cond = Cond::create();
/** The caller must lock the associated Mutex before a call to broadcast **/
var_dump(Cond::wait($cond, $mutex));
/** Always destroy Cond you have created **/
Cond::destroy($cond);
Mutex::unlock($mutex);
Mutex::destroy($mutex);
?>

The above example will output:

int(49685473)