Memcache::decrement

(no version information, might be only in CVS)

Memcache::decrement -- Decrement item's value

Описание

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

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 substracted.

Замечание: 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

Key of the item do decrement.

value

Decrement the item by value. Optional and defaults to 1.

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

Returns item's new value on success or FALSE on failure.

Примеры

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

<?php

/* 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;
$memcache_obj->connect('memcache_host', 11211);
/* decrement item by 3 */
$new_value = $memcache_obj->decrement('test_item', 3);
?>

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

Memcache::increment()
Memcache::replace()