(PECL memcached >= 0.1.0)
Memcached::delete — アイテムを削除する
$key
[, int $time
= 0
] )
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');
?>