Php/docs/function.wincache-ucache-inc

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

wincache_ucache_inc

(PECL wincache >= 1.1.0)

wincache_ucache_inc — キーに関連づけられた値を増加させる

説明

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

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

パラメータ

key

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

inc_by

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

success

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

返り値

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

例

例1 wincache_ucache_inc() の使用法

<?phpwincache_ucache_set('counter', 1);var_dump(wincache_ucache_inc('counter', 2921, $success));var_dump($success);?>

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

int(2922) 
bool(true)

参考

• wincache_ucache_dec() - キーに関連づけられた値を減少させる
• wincache_ucache_cas() - 変数を古い値と比較して新しい値を代入する