apc_inc(3) [php man page]

APC_INC(3)								 1								APC_INC(3)

apc_inc - Increase a stored number

SYNOPSIS

       int apc_inc (string  $key, [int	$step = 1], [bool  &$success])

DESCRIPTION

	Increases a stored number.

PARAMETERS

	      o $key
		- The key of the value being increased.

	      o $step
		- The step, or value to increase.

	      o $success
		- Optionally pass the success or fail boolean value to this referenced variable.

RETURN VALUES

	Returns the current value of $key's value on success, or FALSE on failure

EXAMPLES

       Example #1

	      apc_inc(3) example

	      <?php
	      echo "Let's do something with success", PHP_EOL;

	      apc_store('anumber', 42);

	      echo apc_fetch('anumber'), PHP_EOL;

	      echo apc_inc('anumber'), PHP_EOL;
	      echo apc_inc('anumber', 10), PHP_EOL;
	      echo apc_inc('anumber', 10, $success), PHP_EOL;

	      var_dump($success);

	      echo "Now, let's fail", PHP_EOL, PHP_EOL;

	      apc_store('astring', 'foo');

	      $ret = apc_inc('astring', 1, $fail);

	      var_dump($ret);
	      var_dump($fail);
	      ?>

	      The above example will output something similar to:

	      42
	      43
	      53
	      63
	      bool(true)
	      Now, let's fail

	      bool(false)
	      bool(false)

SEE ALSO 
apc_dec(3).
PHP Documentation Group 														APC_INC(3)

APC_CAS(3)								 1								APC_CAS(3)

apc_cas - Updates an old value with a new value

SYNOPSIS

       bool apc_cas (string  $key, int	$old, int  $new)

DESCRIPTION

       apc_cas(3)  updates  an	already existing integer value if the $old parameter matches the currently stored value with the value of the $new
       parameter.

PARAMETERS

	      o $key
		- The key of the value being updated.

	      o $old
		- The old value (the value currently stored).

	      o $new
		- The new value to update to.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      apc_cas(3) example

	      <?php
	      apc_store('foobar', 2);
	      echo '$foobar = 2', PHP_EOL;
	      echo '$foobar == 1 ? 2 : 1 = ', (apc_cas('foobar', 1, 2) ? 'ok' : 'fail'), PHP_EOL;
	      echo '$foobar == 2 ? 1 : 2 = ', (apc_cas('foobar', 2, 1) ? 'ok' : 'fail'), PHP_EOL;

	      echo '$foobar = ', apc_fetch('foobar'), PHP_EOL;

	      echo '$f__bar == 1 ? 2 : 1 = ', (apc_cas('f__bar', 1, 2) ? 'ok' : 'fail'), PHP_EOL;

	      apc_store('perfection', 'xyz');
	      echo '$perfection == 2 ? 1 : 2 = ', (apc_cas('perfection', 2, 1) ? 'ok' : 'epic fail'), PHP_EOL;

	      echo '$foobar = ', apc_fetch('foobar'), PHP_EOL;
	      ?>

	      The above example will output something similar to:

	      $foobar = 2
	      $foobar == 1 ? 2 : 1 = fail
	      $foobar == 2 ? 1 : 2 = ok
	      $foobar = 1
	      $f__bar == 1 ? 2 : 1 = fail
	      $perfection == 2 ? 1 : 2 = epic fail
	      $foobar = 1

SEE ALSO 
apc_dec(3), apc_store(3).
PHP Documentation Group 														APC_CAS(3)