apcu_dec
PHP function
Edit on GitHub ✎
(PECL apcu >= 4.0.0)
Decrease a stored number
Description
apcu_dec(string $key, int $step = 1, [bool $success], int $ttl = 0): int|false
Decreases a stored integer value.
Parameters
keyThe key of the value being decreased.
stepThe step, or value to decrease.
successOptionally pass the success or fail boolean value to this referenced variable.
ttlTTL to use if the operation inserts a new value (rather than decrementing an existing one).
Return Values
Returns the current value of key's value on success, Falseforfailure
Examples
apcu_dec() example
php
<?php
echo "Let's do something with success", PHP_EOL;
apcu_store('anumber', 42);
echo apcu_fetch('anumber'), PHP_EOL;
echo apcu_dec('anumber'), PHP_EOL;
echo apcu_dec('anumber', 10), PHP_EOL;
echo apcu_dec('anumber', 10, $success), PHP_EOL;
var_dump($success);
echo "Now, let's fail", PHP_EOL, PHP_EOL;
apcu_store('astring', 'foo');
$ret = apcu_dec('astring', 1, $fail);
var_dump($ret);
var_dump($fail);
?>The above example will output something similar to:
output
Let's do something with success
42
41
31
21
bool(true)
Now, let's fail
bool(false)
bool(false)