Decrement item's value

(PECL memcache >= 0.2.0)

Memcache::decrementDecrement item's value


int Memcache::decrement ( string $key [, int $value = 1 ] )

Memcache::decrement() decrements value of the item by value. Similarly to Memcache::increment(), current value of the item is being converted to numerical and after that value is subtracted.


New item's value will not be less than zero.


Do not use Memcache::decrement() with item, which was stored compressed, because consequent call to Memcache::get() will fail.

Memcache::decrement() does not create an item if it didn't exist. Also you can use memcache_decrement() function.

Список параметров


Key of the item do decrement.


Decrement the item by value.

Возвращаемые значения

Returns item's new value on success или FALSE в случае возникновения ошибки.


Пример #1 Memcache::decrement() example


/* procedural API */
$memcache_obj memcache_connect('memcache_host'11211);
/* decrement item by 2 */
$new_value memcache_decrement($memcache_obj'test_item'2);

/* OO API */
$memcache_obj = new Memcache;
/* decrement item by 3 */
$new_value $memcache_obj->decrement('test_item'3);

Смотрите также