« wincache_ucache_clear
wincache_ucache_delete »

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   関連   キー   減少   success   変数   成功   counter   dump   clear   delete   WinCache   mixed   キャッシュ   格納   大文字   小文字   区別   減少幅   浮動   小数   点数   整数   long
関連する関数・ページ:
function.wincache-ucache-inc   function.wincache-ucache-cas   function.wincache-ucache-exists   function.wincache-ucache-get   function.wincache-ucache-clear   function.wincache-ucache-set