phpday 2025 - Call For Papers

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)

参考

add a note

User Contributed Notes

There are no user contributed notes for this page.
To Top