Memcache::connect
Memcache::delete
Memcache
PHP Manual

# Memcache::decrement

(PECL memcache >= 0.2.0)

Memcache::decrement — 項目の値を減らす

### 説明

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

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);
?>`

### 参考

- Memcache::increment() - 項目の値を増やす
- Memcache::replace() - 既存項目の値を置換する

Memcache::connect
Memcache::delete
Memcache
PHP Manual