Php/docs/memcached.add

• PHP Manual
• Memcached
• アイテムを新しいキーで追加する

Memcached::add

(PECL memcached >= 0.1.0)

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

説明

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

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

パラメータ

key

値の格納先のキー。

value

格納する値。

expiration

期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。

返り値

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

参考

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