Memcached::prepend
(PECL memcached >= 0.1.0)
Memcached::prepend — 既存のアイテムの前にデータを付加する
説明
public Memcached::prepend
( string $key
, string $value
) : bool
Memcached::prepend() は、指定した文字列
value を既存のアイテムの前に付加します。
value を文字列に強制変換する理由は、
異なる型を付加した場合の挙動が定義されていないからです。
注意:
Memcached::OPT_COMPRESSIONが有効になっている場合は、 この操作は失敗して警告が発せられます。 すでに圧縮されている可能性のあるデータの先頭に圧縮したデータを付加することはできないからです。
パラメータ
key- データを先頭に付加したいアイテムのキー。
value- 先頭に付加する文字列。
返り値
成功した場合に true を、失敗した場合に false を返します。
Memcached::getResultCode() は、キーが存在しない場合に
Memcached::RES_NOTSTORED を返します。
例
例1 Memcached::prepend() の例
<?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'));?>
上の例の出力は以下となります。
string(6) "defabc"
