Php/docs/function.apcu-inc
From Get docs
apcu_inc
(PECL apcu >= 4.0.0)
apcu_inc — Increase a stored number
Description
apcu_inc
( string $key
[, int $step
= 1
[, bool &$success
[, int $ttl
= 0
]]] ) : int|false
Increases a stored number.
Parameters
key
- The key of the value being increased.
step
- The step, or value to increase.
success
- Optionally pass the success or fail boolean value to this referenced variable.
ttl
- TTL to use if the operation inserts a new value (rather than incrementing an existing one).
Return Values
Returns the current value of key
's value on success,
or FALSE
on failure
Changelog
Version | Description |
---|---|
5.1.12 | The ttl parameter has been added.
|
Examples
Example #1 apcu_inc() example
<?phpecho "Let's do something with success", PHP_EOL;apcu_store('anumber', 42);echo apcu_fetch('anumber'), PHP_EOL;echo apcu_inc('anumber'), PHP_EOL;echo apcu_inc('anumber', 10), PHP_EOL;echo apcu_inc('anumber', 10, $success), PHP_EOL;var_dump($success);echo "Now, let's fail", PHP_EOL, PHP_EOL;apcu_store('astring', 'foo');$ret = apcu_inc('astring', 1, $fail);var_dump($ret);var_dump($fail);?>
The above example will output something similar to:
Let's do something with success 42 43 53 63 bool(true) Now, let's fail bool(false) bool(false)