(PECL apcu >= 4.0.0)

apcu_dec — 减少存储的数量

说明

apcu_dec(
    string $key,
    int $step = 1,
    bool &$success = ?,
    int $ttl = 0
): int|false

减少存储的整数值。

参数

key

值减少的key。

step

要减少的步骤或值。

success

可以选择将成功或失败布尔值传递给此引用的变量。

ttl

如果操作插入新值（而不是递减现有值），则使用 TTL。

返回值

成功时返回键值的当前值，或者在失败时返回 false

示例

示例 #1 apcu_dec() example

<?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);
?>

以上示例的输出类似于：

Let's do something with success
42
41
31
21
bool(true)
Now, let's fail

bool(false)
bool(false)

参见

• apcu_inc() - Increase a stored number