Memcached::add

(PECL memcached >= 0.1.0)

Memcached::add — アイテムを新しいキーで追加する

説明

public bool Memcached::add ( string $key , mixed $value [, int $expiration ] )

Memcached::add() は Memcached::set() と似ていますが、 key が既にサーバー上に存在する場合は失敗します。

パラメータ

key: 値の格納先のキー。
value: 格納する値。
expiration: 期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限を参照ください。

返り値

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

参考

Memcached::addByKey() - 指定したサーバーにアイテムを新しいキーで追加する
Memcached::set() - アイテムを格納する
Memcached::replace() - 既存のキーのアイテムを入れ替える

add a note User Contributed Notes Memcached::add

public at kevingh dot com 28-Oct-2011 11:59


In Memcached v1.4.5, getResultCode() returns Memcached::RES_DATA_EXISTS if the key is already in use.



Otherwise Memcached::RES_SUCCESS is returned.

add a note