Memcache::decrement
(no version information, might be only in CVS)
Memcache::decrement -- 項目の値を減らす
説明
int
Memcache::decrement ( string key [, int value] )
Memcache::decrement() は、項目の値を
value だけ減らします。
Memcache::increment() と同様、項目の現在の値が
まず数値に変換されてから value
を引きます。
注意:
項目の新しい値をゼロより小さくすることはできません。
注意:
圧縮して格納されている項目に対して
Memcache::decrement() を使用しないでください。
なぜなら、それ以降の Memcache::get() のコールが
失敗してしまうからです。
Memcache::decrement() は、指定した項目が
存在しない場合に項目を作成することは
ありません。
memcache_decrement() 関数を使用することも可能です。
パラメータ
- key
値を減らす項目のキー。
- value
項目の値を value だけ減らします。
オプションのパラメータで、デフォルトは 1。
返り値
項目の新しい値か、失敗した場合は FALSE を返します。
例
例 1. Memcache::decrement() の例
<?php
/* 手続き型の API */ $memcache_obj = memcache_connect('memcache_host', 11211); /* 項目の値を 2 減らします */ $new_value = memcache_decrement($memcache_obj, 'test_item', 2);
/* オブジェクト指向の API */ $memcache_obj = new Memcache; $memcache_obj->connect('memcache_host', 11211); /* 項目の値を 3 減らします */ $new_value = $memcache_obj->decrement('test_item', 3); ?>
|
|
参考
Memcache::increment() |
Memcache::replace() |