Memcached::append
(PECL memcached >= 0.1.0)
Memcached::append — Добавляет данные к существующей записи
Описание
$key
, string $value
) : bool
Memcached::append() добавляет переданную в
value
строку к существующей записи. Причина того,
что value
приводится к строке в том, что добавление
смешанных типов не определено.
Замечание:
Если параметр
Memcached::OPT_COMPRESSION
установлен, то операция будет завершена ошибкой и будет выведено предупреждение, потому что добавление сжатых данных к записи, которая уже сжата, невозможно.
Список параметров
-
key
-
Ключ, под которым сохраняется значение.
-
value
-
Строка для добавления.
Возвращаемые значения
Возвращает true
в случае успешного завершения или false
в случае возникновения ошибки.
Метод Memcached::getResultCode() возвращает
Memcached::RES_NOTSTORED
, если переданный ключ не существует.
Примеры
Пример #1 Пример использования Memcached::append()
<?php
$m = new Memcached();
$m->addServer('localhost', 11211);
$m->setOption(Memcached::OPT_COMPRESSION, false);
$m->set('foo', 'abc');
$m->append('foo', 'def');
var_dump($m->get('foo'));
?>
Результат выполнения данного примера:
string(6) "abcdef"
Смотрите также
- Memcached::appendByKey() - Добавляет данные к существующей записи на заданном сервере
- Memcached::prepend() - Добавляет данные в начало существующей записи