在线文档教程

lpush

LPUSH

LPUSH key value [value ...]

自1.0.0起可用。

时间复杂度: O(1)

将所有指定值插入存储在列表头部的位置key。如果key不存在,则在执行推送操作之前将其创建为空列表。当key保存不是列表的值时,将返回错误。

可以使用单个命令调用来推送多个元素,只需在命令末尾指定多个参数即可。元素被一个接一个地插入列表头部,从最左边的元素到最右边的元素。因此,例如,该命令LPUSH mylist a b c将导致包含c第一个元素,b第二个元素和a第三个元素的列表。

返回值

整数回复:推送操作后列表的长度。

历史

  • >= 2.4:接受多个value参数。在2.4以前的Redis版本中,可以为每个命令推送一个值。

例子

redis> LPUSH mylist "world" (integer) 1 redis> LPUSH mylist "hello" (integer) 2 redis> LRANGE mylist 0 -1 1) "hello" 2) "world"