Memcache::decrement

(PECL memcache >= 0.2.0)

Memcache::decrementДекрементировать значение элемента

Описание

Memcache::decrement ( string $key , int $value = 1 ) : int|false

Memcache::decrement() уменьшает значение элемента на величину value. Аналогично Memcache::increment(), текущее значение элемента приводится к числовому и после этого из него вычитается value.

Замечание:

Новое значение элемента не может быть меньше нуля.

Замечание:

Не используйте Memcache::decrement() с элементами, которые были сохранены с использованием сжатия, потому что соответствующий вызов Memcache::get() обернется неудачей.

Memcache::decrement() не создает элемент, если он до этого не существовал. Также вы можете использовать функцию memcache_decrement().

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

key

Ключ декрементируемого элемента.

value

Уменьшение элемента на величину value.

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

При успешном выполнении возвращает новое значение элемента или 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);
?>

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