Memcached::add

(PECL memcached >= 0.1.0)

Memcached::add — Add an item under a new key

Опис

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

Memcached::add() is similar to Memcached::set(), but the operation fails if the key already exists on the server.

Параметри

key: Ключ, під яким зберігається значення.
value: Значення для зберігання.
expiration: Термін зберігання, стандарно — 0. Докладніше: Терміни зберігання.

Значення, що повертаються

Повертає true у разі успіху або false в разі помилки. The Memcached::getResultCode() will return Memcached::RES_NOTSTORED if the key already exists.

Прогляньте також

Memcached::addByKey() - Add an item under a new key on a specific server
Memcached::set() - Store an item
Memcached::replace() - Replace the item under an existing key

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