変数を古い値と比較して新しい値を代入する

# wincache_ucache_cas

(PECL wincache >= 1.1.0)

wincache_ucache_cas — 変数を古い値と比較して新しい値を代入する

### 説明

function wincache_ucache_cas(string `$key`, int `$old_value`, int `$new_value`): bool

指定したキーの変数を `old_value` と比較し、 マッチした場合はそこに `new_value` を代入します。

### パラメータ

`key`

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

`old_value`

  ユーザーキャッシュ内の `key` が指す変数の古い値。 この値は `long` 型でなければならず、 それ以外の場合はこの関数は `false` を返します。

`new_value`

  マッチしたときに `key` が指す変数に代入する新しい値。 この値は `long` 型でなければならず、 それ以外の場合はこの関数は `false` を返します。

### 戻り値

成功した場合に `true` を、失敗した場合に `false` を返します。

### 例

例1 wincache_ucache_cas() の使用法

    <?php
    wincache_ucache_set('counter', 2922);
    var_dump(wincache_ucache_cas('counter', 2922, 1));
    var_dump(wincache_ucache_get('counter'));
    ?>

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

    bool(true)
    int(1)

### 参考

- wincache_ucache_inc() - キーに関連づけられた値を増加させる
- wincache_ucache_dec() - キーに関連づけられた値を減少させる

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