Memcache::decrement
(PECL memcache >= 0.2.0)
Memcache::decrement — Декрементировать значение элемента
Описание
$key
, int $value = 1
) : int|false
Memcache::decrement() уменьшает значение элемента на величину value.
Аналогично Memcache::increment(), текущее значение элемента
приводится к числовому и после этого из него вычитается value.
Замечание:
Новое значение элемента не может быть меньше нуля.
Memcache::decrement() не создает элемент, если он до этого не существовал. Также вы можете использовать функцию memcache_decrement().Замечание:
Не используйте Memcache::decrement() с элементами, которые были сохранены с использованием сжатия, потому что соответствующий вызов Memcache::get() обернется неудачей.
Список параметров
-
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);
?>
Смотрите также
- Memcache::increment() - Увеличить значение элемента
- Memcache::replace() - Заменить значение существующего элемента