列表右推
语法
RPUSH key element [element ...]
- 自版本可用
- 1.0.0
- 时间复杂度
- 每个元素添加的 O(1),因此向列表添加 N 个元素的 O(N) 为当命令使用多个参数调用时。
- ACL 类别
-
@write
,@list
,@fast
,
将所有指定的值插入存储在 key
中的列表的尾部。如果 key
不存在,则在执行推入操作之前将其创建为一个空列表。当 key
包含非列表值时,将返回错误。
可以通过一次命令调用来推入多个元素,只需在命令末尾指定多个参数即可。元素将从左到右依次插入列表的尾部。例如,命令 RPUSH mylist a b c
将导致列表包含 a
作为第一个元素,b
作为第二个元素,c
作为第三个元素。
示例
RESP2/RESP3 回复
整数回复: 推入操作后列表的长度。历史
- 从 Redis 版本 2.4.0 开始:接受多个
element
参数。