mutex.trylock(3) php man page | unix.com

MUTEX.TRYLOCK(3)							 1							  MUTEX.TRYLOCK(3)

Mutex::trylock - Attempt to Acquire Mutex

SYNOPSIS

       finalpublicstatic boolean Mutex::trylock (long  $mutex)

DESCRIPTION

       Attempt to lock the Mutex for the caller without blocking if the Mutex is owned (locked) by another Thread.

PARAMETERS

	      o $mutex
		-A handle returned by a previous call to Mutex.create(3).

RETURN VALUES

	A boolean indication of success.

EXAMPLES

       Example #1

	      Mutex Locking and Unlocking

	      <?php
	      /** You cannot use the "new" keyword, a Mutex is not a PHP object **/
	      $mutex = Mutex::create();
	      /** You can now try to lock the mutex in any context **/
	      var_dump(Mutex::trylock($mutex));
	      /** It is invalid to attempt to destroy a locked Mutex **/
	      var_dump(Mutex::unlock($mutex));
	      /** Always destroy mutex you have created **/
	      Mutex::destroy($mutex);
	      ?>

	      The above example will output:

	      bool(true)
	      bool(true)

PHP Documentation Group 													  MUTEX.TRYLOCK(3)