Memcache::increment
(PECL memcache >= 0.2.0)
Memcache::increment — 項目の値を増やす
説明
Memcache::increment
( string $key
[, int $value
= 1
] ) : int|false
Memcache::increment() は、項目の値を
value
だけ増やします。
もし key
に対応する値が数値ではなく、かつ
数値に変換できなかった場合は、その新しい値は
value
となります。
Memcache::increment() は、指定した項目が
存在しない場合に項目を作成することは
ありません。
注意:
圧縮して格納されている項目に対して Memcache::increment() を使用しないでください。 なぜなら、それ以降の Memcache::get() のコールが 失敗してしまうからです。
memcache_increment() 関数を使用することも可能です。
パラメータ
key
- 値を増やす項目のキー。
value
- 項目の値を
value
だけ増やします。
返り値
項目の新しい値か、失敗した場合に false
を返します。
例
例1 Memcache::increment() の例
<?php/* 手続き型の API */$memcache_obj = memcache_connect('memcache_host', 11211);/* カウンタを 2 増やします */$current_value = memcache_increment($memcache_obj, 'counter', 2);/* オブジェクト指向の API */$memcache_obj = new Memcache;$memcache_obj->connect('memcache_host', 11211);/* カウンタを 3 増やします */$current_value = $memcache_obj->increment('counter', 3);?>