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 を返します
変更履歴
| バージョン | 説明 |
|---|---|
| 5.1.12 | 引数 ttl が追加されました。
|
例
例1 apcu_inc() の例
<?phpecho "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)
