データを既存のアイテムに追記する

# Memcached::append

(PECL memcached >= 0.1.0)

Memcached::append — データを既存のアイテムに追記する

### 説明

public function Memcached::append(string `$key`, string `$value`): ?bool

Memcached::append() は、指定した文字列 `value` を既存のアイテムの値として追記します。 `value` を文字列に強制変換する理由は、 異なる型を追記した場合の挙動が定義されていないからです。

> 注意:

> `Memcached::OPT_COMPRESSION` が有効になっている場合は、 この操作は失敗して警告が発せられます。 すでに圧縮されている可能性のあるデータに圧縮したデータを追記することはできないからです。

### パラメータ

`key`

  値の格納先のキー。

`value`

  追記する文字列。

### 戻り値

成功した場合に `true` を、失敗した場合に `false` を返します。 圧縮が有効になっている場合は `null` を返します。

### エラー / 例外

圧縮が有効になっている場合は `null` を返し、 `E_WARNING` が発生します。

### 例

例1 Memcached::append() の例

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

上の例の出力は以下となります。

    string(6) "abcdef"

### 参考

- Memcached::appendByKey() - 指定したサーバーでデータを既存のアイテムに追記する
- Memcached::prepend() - 既存のアイテムの前にデータを付加する

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open