Memcached::append

(PECL memcached >= 0.1.0)

Memcached::appendAppend data to an existing item

Descrizione

public Memcached::append(string $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.

Nota:

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.

Elenco dei parametri

key

La chiave in cui salvare il valore.

value

The string to append.

Valori restituiti

Restituisce true in caso di successo, false in caso di fallimento. Returns null when compression is on.

Errori/Eccezioni

Returns null and raises an E_WARNING when compression is enabled.

Esempi

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

Il precedente esempio visualizzerĂ :

string(6) "abcdef"

Vedere anche:

add a note add a note

User Contributed Notes 1 note

up
1
mattsch at gmail dot com
9 years ago
This method emits this php warning if OPT_COMPRESSION is not explicitly set to false (tested with libmemcached 1.0.18 & pecl-memcached 2.1.0):

PHP Warning:  Memcached::append(): cannot append/prepend with compression turned on
To Top