« apcu_cache_info
apcu_clear_cache »

apcu_cas

(PECL apcu >= 4.0.0)

apcu_cas — 古い値を新しい値に更新する

説明

function apcu_cas(string $key, int $old, int $new): bool

apcu_cas() は、既に保存されている整数値が old パラメータにマッチする値のときに、それを new パラメータの値に更新します。

パラメータ

key

更新する値のキー。

old

古い値 (現在保存されている値)。

new

新しく更新したい値。

戻り値

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

例

例1 apcu_cas() の例

<?php
apcu_store('foobar', 2);
echo '$foobar = 2', PHP_EOL;
echo '$foobar == 1 ? 2 : 1 = ', (apcu_cas('foobar', 1, 2) ? 'ok' : 'fail'), PHP_EOL;
echo '$foobar == 2 ? 1 : 2 = ', (apcu_cas('foobar', 2, 1) ? 'ok' : 'fail'), PHP_EOL;

echo '$foobar = ', apcu_fetch('foobar'), PHP_EOL;

echo '$f__bar == 1 ? 2 : 1 = ', (apcu_cas('f__bar', 1, 2) ? 'ok' : 'fail'), PHP_EOL;

apcu_store('perfection', 'xyz');
echo '$perfection == 2 ? 1 : 2 = ', (apcu_cas('perfection', 2, 1) ? 'ok' : 'epic fail'), PHP_EOL;

echo '$foobar = ', apcu_fetch('foobar'), PHP_EOL;
?>

上の例の出力は、 たとえば以下のようになります。

$foobar = 2
$foobar == 1 ? 2 : 1 = fail
$foobar == 2 ? 1 : 2 = ok
$foobar = 1
$f__bar == 1 ? 2 : 1 = fail
$perfection == 2 ? 1 : 2 = epic fail
$foobar = 1

参考

関連キーワード:
apcu   foobar   fail   perfection   store   cache   fetch   epic   info   clear   APCu   整数   マッチ   キー   成功   参考   数値   変数   領域   キャッシュ
関連する関数・ページ:
function.apcu-dec   function.apcu-inc   function.apcu-fetch   function.apcu-enabled   function.apcu-key-info   ref.apcu