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