Memcached::replaceByKey
(PECL memcached >= 0.1.0)
Memcached::replaceByKey — 指定したサーバで既存のキーのアイテムを入れ替える
説明
public bool Memcached::replaceByKey
( string $server_key
, string $key
, mixed $value
[, int $expiration
] )
Memcached::replaceByKey() は機能的に Memcached::replace() と同等です。しかし、自由形式の server_key を使用して、 key を特定のサーバに関連付けることができます。 これは、関連するキーを特定のサーバに置き続けたいときなどに便利です。
パラメータ
- server_key
-
値を格納するサーバを表すキー。
- key
-
値の格納先のキー。
- value
-
格納する値。
- expiration
-
期限切れとなるまでの時間。デフォルトは 0。詳細な情報は有効期限 を参照ください。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。 キーが存在しない場合、 Memcached::getResultCode() は Memcached::RES_NOTSTORED を返します。
参考
- Memcached::replace() - 既存のキーのアイテムを入れ替える
- Memcached::set() - アイテムを格納する
- Memcached::add() - アイテムを新しいキーで追加する
There are no user contributed notes for this page.
