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