Redis入门(二)：五大类型 3：列表类型

介绍

• 列表类型（list）能够存储一个有序的字符串列表，经常使用的操做是向列表两端添加元素，或者得到列表的某一个片断。
• 列表类型的内部是双向链表（double linked list）实现的，因此向列表两端添加元素的时间复杂度为O(1)，获取越接近两端的元素速度就越快。一个列表类型最多能容纳2^32-1个元素。

命令

1.向列表两端增长元素

LPUSH key value [value ...]
RPUSH key value [value ...]

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

redis> LPUSH numbers 1
(integer) 1

此时numbers键中的数据为：1

LPUSH 命令还支持同时增长多个元素。

redis> LPUSH numbers 2 3 
(integer) 3

此时numbers键中的数据为：321

RPUSH 命令用来向列表右边增长元素，用法与 LPUSH 同样。

redis> RPUSH numbers 0 -1
(integer) 5

此时numbers键中的数据为：3 2 1 0 -1

2.从列表两端弹出元素

LPOP key
RPOP key

LPOP 命令能够从列表左边弹出一个元素。LPOP 命令执行有两步操做：第一步是将列表左边的元素从列表中移除，第二步是返回被移除的元素值。

redis> LPOP numbers
"3"

此时numbers键中的数据为：2 1 0 -1

一样，RPOP 命令能够从列表右边弹出一个元素。

redis> RPOP numbers
"-1"

此时元素的数据为：2 1 0

3.获取列表中元素的个数

LLEN key

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

redis> LLEN numbers
(integer) 3

LLEN 命令的功能相似 SQL 语句SELECT COUNT(*) FROM table_name，可是LLEN的时间复杂度为O(1)，使用Redis  
会直接读取现成的值，而不须要像部分关系数据库那样须要遍历一遍数据表来统计条目数量。

4.得到列表片断

LRANGE key start stop

LRANGE 命令将返回索引从 start 到 stop 之间的全部元素（包含两端的元素）。Redis 的列表起始索引为：0。

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

LRANGE 命令也支持索引，表示从右边开始计算序数，如“-1”表示最右边第一个元素，“-2”表示最右边第二个元素，依此类推。

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

显然，LRANGE numbers 0 -1 能够获取列表中的全部元素。另一些特殊状况以下。

• 若是 start 的索引位置比 stop 的索引位置靠后，则会返回空列表。
• 若是 stop 大于实际的索引范围，则会返回到列表最右边的元素。

5.删除列表中指定的值

LREM key count value

LREM 命令会删除列表中前count个值为value的元素，返回值是实际删除的元素个数。根据count值的不一样，LREM命令的执行方式会略有差别。
（1）当 count > 0 时 LREM 命令会从列表左边开始删除前 count 个值为 value 的元素。
（2）当 count > 0 时 LREM 命令会从列表右边开始删除前 count 个值为 value 的元素。
（3）当 count > 0 时 LREM 命令会删除全部值为 value 的元素。

redis> RPUSH numbers 2
(integer) 4
redis> LRANGE numbers 0 -1
1) "2"
2) "1"
3) "0"
4) "2"

# 从右边开始删除第一个值为“2”的元素
redis> LREM numbers -1 2
(integer) 1
redis> LRANGE numbers 0 -1
1) "2"
2) "1"
3) "0"

6.得到/设置指定索引的元素值

LINDEX key index
LSET key index value

若是要将列表类型看成数组来使用，LINDEX命令是必不可少的。
LINDEX命令用来返回指定索引的元素，索引从0开始。

redis> LINDEX numbers 0
"2"

若是index是负数，则表示从右边开始计算的索引，最右边元素的索引是-1。

redis> LINDEX numbers -1
"0"

LSET 是另外一个经过索引操做列比的命令，它会将索引为index的元素赋值为value。

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

7.只保留列表指定片断

LTRIM key start end

LTRIM 命令能够删除指定索引范围以外的全部元素，其指定列表范围的方法和LRANGE命令相同。

LTRIM numbers 0 -1
1) "1"
2) "2"
3) "7"
4) "3"
"0"
redis> LTRIM numbers 1 2
OK
redis> LRANGE numbers 0 1
1) "2"
2) "7"

8.向列表中插入元素

LINSERTF 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"

9.将元素从一个列表转到另外一个列表

RPOPLPUSH source destination

先执行 RPOP 命令再执行 LPUSH 命令。 RPOPLPUSH 命令会先从 source 列表类型键的右边弹出一个元素，而后将其加入到 destination 列表类型键的左边，并返回这个元素的值，整个过程是原子的。

整理自《Redis 入门指南第二版》。