Memcached::prepend

Prepend data to an existing item

&reftitle.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.

If the `Memcached::OPT_COMPRESSION` is 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.

&reftitle.parameters;

`key`

- The key of the item to prepend the data to.

`value`

- The string to prepend.

&reftitle.returnvalues;

&return.success; The `Memcached::getResultCode` will return `Memcached::RES_NOTSTORED` if the key does not exist.

&reftitle.examples;

### `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'));
    ?>

&example.outputs;

    string(6) "defabc"

&reftitle.seealso;

- `Memcached::prependByKey`
- `Memcached::append`