<redis-5> 3.3 redis数据类型之列表类型(list)

[b]3.3 列表类型[/b]
[b]3.3.1 介绍[/b]
列表类型（list）可以存储一个[color=red]有序的字符串列表[/color]，常用的操作是向列表[b]两端[/b]添加元素，或者获得列表的某一个片段。列表类型内部是使用[color=red]双向链表[/color]（double linked list）实现的，所以向列表两端添加元素的时间复杂度为0(1)，获取越接近两端的元素速度就越快。这意味着即使是一个有几千万个元素的列表，获取头部或尾部的10条记录也是极快的（和从只有20个元素的列表中获取头部或尾部的10条记录的速度是一样的）。[color=red]不过使用链表的代价是通过索引访问元素比较慢[/color]。

这种特性使列表类型能非常快速地完成关系数据库难以应付的场景：如社交网站的新鲜事，我们关心的只是[b]最新的内容[/b]，使用列表类型存储，即使新鲜事的总数达到几千万个，获取其中[b]最新的100条数据也是极快的[/b]。同样因为在两端插入记录的时间复杂度是0(1)，列表类型也适合用来记录日志，可以保证加入新日志的速度不会受到已有日志数量的影响。
与散列类型键最多能容纳的字段数量相同，[color=red]一个列表类型键最多能容纳2^32-1个元素[/color]。

[b]3.3.2 命令[/b]
[b]1．向列表两端增加元素[/b]

LPUSH key value [value …]
RPUSH key value [value …]

LPUSH命令用来向列表左边增加元素，返回值表示增加元素后列表的长度。

redis＞LPUSH numbers 1
(integer) 1

[b]2．从列表两端弹出元素[/b]

LPOP key
RPOP key

有进有出，LPOP命令可以从列表[b]左边弹出[/b]一个元素。
LPOP命令执行两步操作：
第一步是将列表左边的元素从列表中[color=red]移除[/color]；
第二步是返回被移除的元素值。例如，从numbers列表左边弹出一个元素（也就是"3"）：

redis＞LPOP numbers
"3"

结合上面提到的4个命令可以使用列表类型来[color=red]模拟栈和队列[/color]的操作：如果想把列表当做栈，则搭配使用LPUSH和LPOP或RPUSH和RPOP，如果想当成队列，则搭配使用LPUSH和RPOP或RPUSH和LPOP。

[b]3．获取列表中元素的个数[/b]

LLEN key

当键不存在时LLEN会返回0：

redis＞LLEN numbers
(integer) 3

LLEN命令的功能类似SQL语句SELECT COUNT(*) FROM table_name，但是LLEN的[color=red]时间复杂度为0(1)[/color]，使用时Redis会直接读取现成的值，而不需要像部分关系数据库（如使用InnoDB 存储引擎的MySQL表）那样需要遍历一遍数据表来统计条目数量。

[b]4．获得列表片段[/b]

LRANGE key start stop

LRANGE命令是列表类型最常用的命令之一，它能够获得列表中的某一片段。LRANGE命令将返回索引从start到stop之间的所有元素（[b]包含两端的元素[/b]）。与大多数人的直觉相同，Redis的列表起始索引为0：

redis＞LRANGE numbers 0 2
1) "2"
2) "1"
3) "0"

LRANGE命令在取得列表片段的同时[color=red][b]不会[/b]像LPOP一样删除该片段[/color]，另外LRANGE命令与很多语言中用来截取数组片段的方法slice有一点区别是LRANGE返回的值包含最右边的元素。
LRANGE命令[color=red]支持负索引[/color]，[b]表示从右边开始计算序数[/b]，如"-1"表示最右边第一个元素，"-2"表示最右边第二个元素，依次类推：

redis＞LRANGE numbers -2 -1
1) "1"
2) "0"

[color=red][b]显然，LRANGE numbers 0 -1可以获取列表中的所有元素。[/b][/color]另外一些特殊情况如下。
（1）如果start的索引位置比stop的索引位置靠后，则会返回空列表。
（2）如果stop大于实际的索引范围，则会返回到列表最右边的元素

[b]5．删除列表中指定的值[/b]

LREM key count value

[color=red]LREM命令会删除列表中前count个值为value的元素，返回值是实际删除的元素个数。[/color]根据count值的不同，LREM命令的执行方式会略有差异：
[list]
[*]●当count＞0时LREM命令会从列表左边开始删除前count个值为value的元素；
[*]●当count＜0时LREM 命令会从列表右边开始删除前|count|个值为value的元素；
[*]●当count=0是LREM命令会删除所有值为value的元素
[/list]

#从右边开始删除第一个值为"2"的元素

redis＞LREM numbers -1 2
(integer) 1
redis＞LRANGE numbers 0 -1
1) "2"
2) "1"
3) "0"

[b]6. 获得/设置指定索引的元素值[/b]

LINDEX key index
LSET key index value

如果要将列表类型当作数组来用，LINDEX命令是必不可少的。LINDEX命令用来返回指定索引的元素，索引从0开始。如：

redis＞LINDEX numbers 0
"2"

如果index是[b]负数[/b]则表示从右边开始计算的索引，最右边元素的索引是-1。例如：

redis＞LINDEX numbers -1
"0"

LSET是另一个通过索引操作列表的命令，它会将索引为index的元素赋值为value。例如：

redis＞LSET numbers 1 7
OK
redis＞LINDEX numbers 1
"7"

注意，这个命令只能修改指定索引元素的值，不能新增。如果index超过了list的下标范围，则会返回错误提示：(error) ERR index out of range

[b]7．只保留列表指定片段[/b]

LTRIM key start end

LTRIM命令可以[color=red]删除指定索引范围之外的所有元素[/color]，其指定列表范围的方法和LRANGE命令相同。
[color=red]LTRIM命令常和LPUSH命令一起使用来限制列表中元素的数量，[/color]比如记录日志时我们希望只保留最近的100条日志，则每次加入新元素时调用一次LTRIM命令即可：

LPUSH logs newLog
LTRIM logs 0 99

[b]8．向列表中插入元素[/b]

LINSERT key BEFORE|AFTER pivot value

LINSERT命令首先会在列表中从左到右查找值为pivot的元素，然后根据第二个参数是BEFORE还是AFTER来决定将value插入到该元素的前面还是后面。
LINSERT命令的返回值是插入后列表的元素个数。示例如下：

redis＞LRANGE numbers 0 -1
1) "2"
2) "7"
3) "0"
redis＞LINSERT numbers AFTER 7 3
(integer) 4
redis＞LRANGE numbers 0 -1
1) "2"
2) "7"
3) "3"
4) "0"
redis＞LINSERT numbers BEFORE 2 1
(integer) 5
redis＞LRANGE numbers 0 -1
1) "1"
2) "2"
3) "7"
4) "3"
5) "0"

[b]9．将元素从一个列表转到另一个列表R[/b]

RPOPLPUSH source destination

RPOPLPUSH是个很有意思的命令，从名字就可以看出它的功能：[color=red]先执行RPOP命令再执行LPUSH 命令。RPOPLPUSH命令会先从source列表类型键的右边弹出一个元素，然后将其加入到destination列表类型键的左边，并返回这个元素的值，整个过程是原子的。[/color]