Memcached::prependByKey()
(PECL memcached >= 0.1.0)
Prepend data to an existing item on a specific server
说明
public Memcached::prependByKey(string $server_key,string $key,string $value): bool
除了可以使用$server_key自由的将$key映射到指定服务器外,Memcached::prependByKey()在功能上等同于Memcached::prepend()。(译注:关于*ByKey系列方法及$server_key的工作原理请参照addByKey方法文档)
参数
- $server_key
本键名用于识别储存和读取值的服务器。没有将实际的键名散列到具体的项目,而是在决定与哪一个 memcached 服务器通信时将其散列为服务器键名。这使得关联的项目在单一的服务上被组合起来以提高多重操作的效率。
- $key
要向前追加数据的元素的key。
- $value
要追加的字符串。
返回值
成功时返回TRUE
,或者在失败时返回FALSE
。如果key不存在,Memcached::getResultCode()返回Memcached::RES_NOTSTORED
。
参见
- Memcached::prepend() 向一个已存在的元素前面追加数据
- Memcached::append() 向已存在元素后追加数据