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

# wincache_ucache_cas

(PECL wincache >= 1.1.0)

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

### 説明

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() - キーに関連づけられた値を減少させる