Php/docs/function.wincache-ucache-dec

• PHP Manual
• WinCache 関数
• キーに関連づけられた値を減少させる

wincache_ucache_dec

(PECL wincache >= 1.1.0)

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

説明

wincache_ucache_dec ( string $key [, int $dec_by = 1 [, bool &$success ]] ) : mixed

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

パラメータ

key

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

dec_by

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

success

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

返り値

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

例

例1 wincache_ucache_dec() の使用法

<?phpwincache_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() - 変数を古い値と比較して新しい値を代入する