(PECL memcached >= 0.1.0)
Memcached::append — Append data to an existing item
$key
, string $value
) : bool
Memcached::append() appends the given
value
string to the value of an existing item. The
reason that value
is forced to be a string is
that appending mixed types is not well-defined.
Note:
If the
Memcached::OPT_COMPRESSION
is enabled, the operation will fail and a warning will be issued, because appending compressed data to a value that is potentially already compressed is not possible.
key
The key under which to store the value.
value
The string to append.
Returns TRUE
on success or FALSE
on failure.
The Memcached::getResultCode() will return
Memcached::RES_NOTSTORED
if the key does not exist.
Example #1 Memcached::append() example
<?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'));
?>
The above example will output:
string(6) "abcdef"