wincache_ucache_dec

キーに関連づけられた値を減少させる

説明

mixed wincache_ucache_dec(string $key, int $dec_by = 1, bool &$success = ?)

key に関連づけられた値を、1 あるいは dec_by で指定した数だけ減らします。

パラメータ

key

変数をキャッシュに格納するときに使ったキーの名前。 key は大文字小文字を区別します。

dec_by

key に関連づけられた変数の減少幅。 浮動小数点数を指定した場合は、最も近い整数に丸められます。 key に関連づけられた変数は long 型でなければならず、 それ以外の場合はこの関数は失敗して false を返します。

success

成功した場合に true、失敗した場合に false が設定されます。

戻り値

成功した場合に減少後の値、失敗した場合に false を返します。

例1 wincache_ucache_dec の使用法

<?php
wincache_ucache_set('counter', 1);
var_dump(wincache_ucache_dec('counter', 2923, $success));
var_dump($success);
?>

上の例の出力は以下となります。

int(2922) 
bool(true)

参考

  • wincache_ucache_inc
  • wincache_ucache_cas