Memcached::prepend
Memcached::prepend
(PECL memcached >= 0.1.0)
Memcached::prepend — Prepend data to an existing item
Description
public bool Memcached::prepend ( string $key , string $value )
Memcached::prepend() prepends the given value string to the value of an existing item. The reason that value is forced to be a string is that prepending mixed types is not well-defined.
Note: If theMemcached::OPT_COMPRESSIONis enabled, the operation will fail and a warning will be issued, because prepending compressed data to a value that is potentially already compressed is not possible.
Parameters
key
The key of the item to prepend the data to.
value
The string to prepend.
Return Values
Returns TRUE on success or FALSE on failure. The Memcached::getResultCode() will return Memcached::RES_NOTSTORED if the key does not exist.
Examples
Example #1 Memcached::prepend() example
<?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')
?>
The above example will output:
string(6) "defabc"
See Also
- Memcached::prependByKey() - Prepend data to an existing item on a specific server
- Memcached::append() - Append data to an existing item
← Memcached::isPristine
Memcached::prependByKey →
© 1997–2017 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
