Memcache::decrement

memcache_decrement

(PECL memcache >= 0.2.0)

Memcache::decrement -- memcache_decrement — 减小元素的值

说明

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

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

Memcache::decrement() 将元素的值减小 value。类似于 Memcache::increment()，首先将元素当前值转换成数值然后减去 value。

注意: 新的元素的值不会小于 0。

注意: 不要将 Memcache::decrement() 用于已压缩存储的元素，那样做会导致 Memcache::get() 方法获取值会失败。

Memcache::decrement() 在元素不存在时不会创建。

参数

key: 要减小值的元素的key。
value: value参数指要将指定元素的值减小多少。

返回值

成功的时候返回元素的新值或者在失败时返回 false

示例

示例 #1 Memcache::decrement() example

<?php

/* procedural API */
$memcache_obj = memcache_connect('memcache_host', 11211);
/* 将test_item对应的值减小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() - 替换已经存在的元素的值