apcu_dec

(PECL apcu >= 4.0.0)

apcu_dec — 保存した数値を減らす

説明

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

保存した整数値を減らします。

パラメータ

key: 減らしたい値のキー。
step: 減らしたい数。
success: この参照渡しの変数に、成功したか失敗したかの結果が格納されます。
ttl: (既存の値を減らすのではなく) 新しい値を挿入する操作に使うTTL

戻り値

成功した場合に key の現在値を返します。失敗した場合に false を返します

例

例1 apcu_dec() の例


<?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() - 保存した数値を増やす

関連キーワード: 　保存, 数値, apcu, key, int, success, 成功, 失敗, 参考, fail