redis列表-list

Posted 2021-03-14 zhuruichao

Redis的list类型其实就是一个每个子元素都是string类型的双向链表，链表的最大长度是2^32。list既可以用做栈，也可以用做队列。

常用命令：

1. lpush key value [value...]:

　　将一个或多个值 value 插入到列表 key 的表头

　　如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表头： 比如说，对空列表 mylist 执行命令 LPUSH mylist a b c ，列表的值将是 c b a ，

　　这等同于原子性地执行 LPUSH mylist a 、 LPUSH mylist b 和 LPUSH mylist c 三个命令。

　　如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。

　　当 key 存在但不是列表类型时，返回一个错误。

　　返回值：执行 LPUSH 命令后，列表的长度。

2. lpushx key value:

　　将值 value 插入到列表 key 的表头，当且仅当 key 存在并且是一个列表。

　　和 LPUSH key value [value …] 命令相反，当 key 不存在时， LPUSHX 命令什么也不做。

　　返回值：LPUSHX 命令执行之后，表的长度。

3. rpush key value [value...]:

　　将一个或多个值 value 插入到列表 key 的表尾(最右边)。

　　如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表尾：比如对一个空列表 mylist 执行 RPUSH mylist a b c ，得出的结果列表为 a b c ，

　　等同于执行命令 RPUSH mylist a 、 RPUSH mylist b 、 RPUSH mylist c 。

　　如果 key 不存在，一个空列表会被创建并执行 RPUSH 操作。

　　当 key 存在但不是列表类型时，返回一个错误。

4. rpushx key value:

　　将值 value 插入到列表 key 的表尾，当且仅当 key 存在并且是一个列表。

　　和 RPUSH key value [value …] 命令相反，当 key 不存在时， RPUSHX 命令什么也不做。

5. lpop key: 移除并返回列表 key 的头元素。当 key 不存在时，返回 nil 。

6. rpop key: 移除并返回列表 key 的尾元素。 当 key 不存在时，返回 nil 。

7. rpoplpush source destination:把source 的末尾拿出，放到destination头部，并返回单元值

　　命令 RPOPLPUSH 在一个原子时间内，执行以下两个动作：

• 将列表 source 中的最后一个元素(尾元素)弹出，并返回给客户端。

• 将 source 弹出的元素插入到列表 destination ，作为 destination 列表的的头元素。

　　举个例子，你有两个列表 source 和 destination ， source 列表有元素 a, b, c ， destination 列表有元素 x, y, z ，

　　执行 RPOPLPUSH source destination 之后， source 列表包含元素 a, b ， destination 列表包含元素 c, x, y, z ，并且元素 c 会被返回给客户端。

　　如果 source 不存在，值 nil 被返回，并且不执行其他动作。

　　如果 source 和 destination 相同，则列表中的表尾元素被移动到表头，并返回该元素，可以把这种特殊情况视作列表的旋转(rotation)操作。

8. lrem key count value: 根据参数 count 的值，移除列表中与参数 value 相等的元素。

　　count 的值可以是以下几种：

• count > 0 : 从表头开始向表尾搜索，移除与 value 相等的元素，数量为 count 。

• count < 0 : 从表尾开始向表头搜索，移除与 value 相等的元素，数量为 count 的绝对值。

• count = 0 : 移除表中所有与 value 相等的值。

　　返回值：被移除元素的数量。 因为不存在的 key 被视作空表(empty list)，所以当 key 不存在时， LREM 命令总是返回 0 。

9. llen key:返回列表 key 的长度。

　　如果 key 不存在，则 key 被解释为一个空列表，返回 0 .

　　如果 key 不是列表类型，返回一个错误。

10. lindex key index: 返回列表 key 中，下标为 index 的元素。

　　下标(index)参数 start 和 stop 都以 0 为底，也就是说，以 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。

　　你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

　　如果 key 不是列表类型，返回一个错误。

11. linsert key before|after pivot value:

　　将值 value 插入到列表 key 当中，位于值 pivot 之前或之后。

　　当 pivot 不存在于列表 key 时，不执行任何操作。

　　当 key 不存在时， key 被视为空列表，不执行任何操作。

　　如果 key 不是列表类型，返回一个错误。

　　返回值：如果命令执行成功，返回插入操作完成之后，列表的长度。 如果没有找到 pivot ，返回 -1 。 如果 key 不存在或为空列表，返回 0 。

12. lset key index value:

　　将列表 key 下标为 index 的元素的值设置为 value 。

　　当 index 参数超出范围，或对一个空列表( key 不存在)进行 LSET 时，返回一个错误。

13. lrange key start stop:返回链表中[start, stop]中的元素

　　返回列表 key 中指定区间内的元素，区间以偏移量 start 和 stop 指定。

　　下标(index)参数 start 和 stop 都以 0 为底，也就是说，以 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。

　　你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

14. ltrim key start stop:剪切key对应的链接，切[start, stop]一段并把改制重新赋给key

　　对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。

　　举个例子，执行命令 LTRIM list 0 2 ，表示只保留列表 list 的前三个元素，其余元素全部删除。

　　下标(index)参数 start 和 stop 都以 0 为底，也就是说，以 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。

　　你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。

　　当 key 不是列表类型时，返回一个错误。

　　超出范围的下标值不会引起错误。

　　如果 start 下标比列表的最大下标 end ( LLEN list 减去 1 )还要大，或者 start > stop ， LTRIM 返回一个空列表(因为 LTRIM 已经将整个列表清空)。

　　如果 stop 下标比 end 下标还要大，Redis将 stop 的值设置为 end 。

15. brpop/blpop key timeout：等待弹出key的尾/头元素

　　　　　　　　　　　　　timeout为等待超时时间，如果timeout为0则一直等待下去

　　　　　　　　　　　　　 应用场景：长轮询ajax，在线聊天时能用到

 

应用场景：

　　1.用户消息时间线 timeline，因为list是有序的，可以做用户时间线

　　2.消息队列