apcu_inc

保存した数値を増やす

説明

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

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

パラメータ

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