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_COMPRESSIONfalse);

$m->set('foo''abc');
$m->prepend('foo''def');
var_dump($m->get('foo'));
?>

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

string(6) "defabc"

参考

関連キーワード:  付加, データ, アイテム, Memcached, 既存, prepend, 先頭, string, キー, 失敗