LPUSHX

仅当列表存在时才将一个或多个元素添加到列表中。

语法

LPUSHX key element [element ...]

引入版本：2.2.0

复杂度摘要：O(1)

仅当 key 已存在并保存列表时，才将指定值插入存储在 key 的列表的头部。与 LPUSH 相反，当 key 尚不存在时，不会执行任何操作。

必需参数

key

保存列表的键的名称。

element [element ...]

仅当列表已存在时，才将一个或多个值添加到列表中。

示例

redis> LPUSH mylist "World"
(integer) 1
redis> LPUSHX mylist "Hello"
(integer) 2
redis> LPUSHX myotherlist "Hello"
(integer) 0
redis> LRANGE mylist 0 -1
1) "Hello"
2) "World"
redis> LRANGE myotherlist 0 -1
(empty array)

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动

返回值

RESP2

整数回复：push操作后的列表长度。

RESP3

整数回复：push操作后的列表长度。

资料来源：Redis 官方 LPUSHX 文档；中文内容参考 Redis 文档许可。