アイテムを削除する

# Memcached::delete

(PECL memcached >= 0.1.0)

Memcached::delete — アイテムを削除する

### 説明

public Memcached::delete ( string `$key` [, int `$time` = 0 ] ) : bool

Memcached::delete() は、キー `key` をサーバーから削除します。 `time` パラメータは、このキーによる add コマンドや replace コマンドをサーバーに拒否させたい秒数 (あるいはいつまで拒否するかを表す Unix タイム) を指定します。 この時間までの間、アイテムは削除キューに入れられます。つまり、 get コマンドによる取得はできず、 add コマンドや replace コマンドでこのキーを指定した場合も失敗するということです (set コマンドは成功します)。 時間が経過したら、アイテムはサーバーのメモリ上から削除されます。 パラメータ `time` のデフォルトは 0 (アイテムは即時に削除され、それ以降の格納コマンドが成功するようになる) です。

### パラメータ

`key`

  削除したいキー。

`time`

  サーバーがアイテムを削除するまでの待ち時間。

### 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。 キーが存在しない場合、 Memcached::getResultCode() は `Memcached::RES_NOTFOUND` を返します。

### 例

例1 Memcached::delete() の例

`<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->delete('key1');
?>`

### 参考

- Memcached::deleteByKey() - 指定したサーバーからアイテムを削除する
- Memcached::deleteMulti() - 複数のアイテムを削除する