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

# 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() の使用法

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