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() - Заменяет существующую запись с указанным ключом

Улучшение страницы

Инструкция • Исправление • Сообщение об ошибке

＋Добавить примечание

Примечания пользователей 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.

＋Добавить примечание