指定したサーバーで既存のアイテムの前にデータを付加する

# Memcached::prependByKey

(PECL memcached >= 0.1.0)

Memcached::prependByKey — 指定したサーバーで既存のアイテムの前にデータを付加する

### 説明

public Memcached::prependByKey ( string `$server_key` , string `$key` , string `$value` ) : bool

Memcached::prependByKey() は機能的に Memcached::prepend() と同等です。しかし、自由形式の `server_key` を使用して、 `key` を特定のサーバーに関連付けることができます。

### パラメータ

`server_key`

  値を格納したりデータを取得したりするサーバーを表すキー。 アイテムの実際のキーをハッシュするかわりにサーバーのキーをハッシュして、どの memcached サーバーとやりとりするのか選びます。 これで、関連するアイテムを一つのサーバーにまとめられるようになり、マルチ操作の効率が上がります。

`key`

  データを先頭に付加したいアイテムのキー。

`value`

  先頭に付加する文字列。

### 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。 Memcached::getResultCode() は、キーが存在しない場合に `Memcached::RES_NOTSTORED` を返します。

### 参考

- Memcached::prepend() - 既存のアイテムの前にデータを付加する
- Memcached::append() - データを既存のアイテムに追記する