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

# wincache_ucache_dec

(PECL wincache >= 1.1.0)

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

### 説明

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open