lpush/rpush
lpush/rpush key value[value…]
功能:将一个或多个值value插入到列表key的表头/表尾(表头在左表尾在右)
说明:如果有多个value值,对于lpush来说,各个value会按从左到右的顺序依次插入到表头;对于rpush来说,各个value会按从左到右的顺序依次插入到表头如果 key 不存在;一个空列表会被创建并执行操作。 当 key 存在但不是列表类型时,返回一个错误。执行成功时返回列表长度。
llen
llen key
功能:返回列表key的长度。
** 说明**: 如果列表 key 不存在,则 key 被解释为一个空列表,返回 0 。 如果 key 不是列表类型,返回一个错误。
lindex
lindex key index
功能:返回列表key中,下标为index的元素。列表从0开始计数。
说明:如果指定索引值不在列表的区间范围内,返回 nil 。
lset
lset key index value
功能:将列表key下标为index的元素的值设置为value。
说明:当索引参数超出范围,或对一个空列表进行 LSET 时,返回一个错误。
lrange
lrange key start stop
功能:返回列表key中指定区间【start,stop】内的元素,即包含两个端点。
** 说明**: 其中 0 表示列表的第一个元素, 1 表示列表的第二个元素,以此类推。 你也可以使用负数下标,以 -1 表示列表的最后一个元素, -2 表示列表的倒数第二个元素,以此类推。
lpushx/rpushx
lpushx/rpushx key value
功能: 将值value插入到列表key的表头/表尾,当且仅当key存在并且是一个列表。
说明:当key不存在时,命令什么也不做。若执行成功,列表的长度。
linsert
LINSERT key BEFORE|AFTER pivot value
功能:将值 value 插入到列表 key 当中,位于值 pivot 之前或之后。
说明:如果命令执行成功,返回插入操作完成之后,列表的长度。 如果没有找到指定元素 ,返回 -1 。 如果 key 不存在或为空列表,返回 0 。
lpop/rpop
LPOP key【count】/rpop key【count】
功能:从列表key的表头/表尾移除count个元素,并返回移除元素。count默认值为1。
说明:当key不存在时,返回nil。
blop/brpop
BLPOP key1 [key… ] timeout/BRPOP key1 [key… ] timeout
功能:BLPOP 是列表的阻塞式(blocking)弹出原语。它是 LPOP key 命令的阻塞版本,当给定列表内没有任何元素可供弹出的时候,连接将被 BLPOP 命令阻塞,直到等待超时或发现可弹出元素为止。当给定多个 key 参数时,按参数 key 的先后顺序依次检查各个列表,弹出第一个非空列表的头元素。
** 说明**:如果列表为空,返回一个 nil 。 否则,返回一个含有两个元素的列表,第一个元素是被弹出元素所属的 key ,第二个元素是被弹出元素的值。
rpoplpush
RPOPLPUSH source destination
功能:命令RPOPLPUSH在一个原子时间内,执行以下两个动作:
- 将列表source中的最后一个元素弹出,并返回给客户端。
- 将source 弹出的元素插入到列表destination,作为destination列表的头元素。
如果source不存在,值nil被返回,并且不执行其他动作。如果source和destination相同,则列表中的表尾元素被移动到表头,并返回该元素,可以把这种特殊情况视作列表的旋转(rotation)操作。
brpoplpush
BRPOPLPUSH source destination timeout
功能:从列表中取出最后一个元素,并插入到另外一个列表的头部; 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
说明:假如在指定时间内没有任何元素被弹出,则返回一个 nil 和等待时长。 反之,返回一个含有两个元素的列表,第一个元素是被弹出元素的值,第二个元素是等待时长。
lrem
lrem key start stop
功能:根据参数 COUNT 的值,移除列表中与参数 VALUE 相等的元素。
- count > 0 : 从表头开始向表尾搜索,移除与 VALUE 相等的元素,数量为 COUNT 。
- count < 0 : 从表尾开始向表头搜索,移除与 VALUE 相等的元素,数量为 COUNT 的绝对值。
- count = 0 : 移除表中所有与 VALUE 相等的值。
说明:返回被移除元素的数量。 当列表不存在时返回 0 。
ltrim
LTRIM key start stop
功能:对一个列表进行修剪(trim),就是说,让列表只保留指定区间内的元素,不在指定区间之内的元素都将被删除。
说明:下标 0 表示列表的第一个元素,以 1 表示列表的第二个元素,以此类推。 你也可以使用负数下标,以 -1 表示列表的最后一个元素, -2 表示列表的倒数第二个元素,以此类推。