apcu_inc

(PECL apcu >= 4.0.0)

apcu_inc — 保存した数値を増やす

説明

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

保存した整数値を増やします。

パラメータ

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

戻り値

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

例

例1 apcu_inc() の例


<?php
echo "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);
?>

上の例の出力は、たとえば以下のようになります。

Let's do something with success
42
43
53
63
bool(true)
Now, let's fail

bool(false)
bool(false)

参考

apcu_dec() - 保存した数値を減らす

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