Memcached::append
(PECL memcached >= 0.1.0)
Memcached::append — データを既存のアイテムに追記する
説明
public bool Memcached::append
( string
$key
, string $value
)
Memcached::append() は、指定した文字列
value を既存のアイテムの値として追記します。
value を文字列に強制変換する理由は、
異なる型を追記した場合の挙動が定義されていないからです。
注意:
Memcached::OPT_COMPRESSIONが有効になっている場合は、 この操作は失敗して警告が発せられます。 すでに圧縮されている可能性のあるデータに圧縮したデータを追記することはできないからです。
パラメータ
-
key -
値の格納先のキー。
-
value -
追記する文字列。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
Memcached::getResultCode() は、キーが存在しない場合に
Memcached::RES_NOTSTORED を返します。
例
例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"
忘却曲線を使ってこの知識を確実に記憶に残す
