Memcached::add

(PECL memcached >= 0.1.0)

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

説明

public Memcached::add(string $key, mixed $value, int $expiration = 0): bool

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

パラメータ

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

戻り値

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

参考

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

Improve This Page

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 1 note

down

ilya dot chase at yandex dot ru ¶

5 years ago

Note that this operation is atomic, means that it's safe from race condition operation (since memcached is running in single process). You can use this method for locks and can be sure that two requests will not get "true" simultaneously using this method.

＋add a note