Redis list 类型学习笔记与总结

redis 版本

[root@localhost ~]# redis-server --version
redis server v=2.8.19 sha=00000000:0 malloc=jemalloc-3.6.0 bits=32 build=e2559761bd460ca0

list 是一个链表结构，主要功能是 push（类似 php 的 array_push() 方法）、 pop（类似 php 的 array_pop() 方法）、获取一个范围的所有值 等， 操作

中 key 理解为链表的名字。redis 的 list 类型其实就是一个每个子元素都是 string 类型的 双向链表。

链表的最大长度是(2的 32 次方)。我们可以通过 push, pop 操作从链表的头部或者尾部添加删除元素。这使得 list 既可以用作栈，也可以用作队列。

有意思的是 list 的 pop 操作还有阻塞版本的，当我们[lr]pop 一个 list 对象时，如果 list 是空，或者不存在，会立即返回 nil。但是阻塞版本的 b[lr]pop 可以则可以阻塞，当然可以加超时时间，超时后也会返回 nil。为什么要阻塞版本的 pop 呢，主要是为了避免轮询。举个简单的例子如果我们用 list 来实现一个工作队列。执行任务的 thread 可以调用阻塞版本的 pop 去获取任务这样就可以避免轮询去检查是否有任务存在。当任务来时候工作线程可以立即返回，也可以避免轮询带来的延迟。

① lpush 方法（栈）

在 key 对应 list 的头部 添加（压入）字符串元素。

② lrange 方法

lrange list1 0 -1 代表从链表 list1 的头部第一个元素取到 尾部第一个元素（-1 代表尾部第一个元素）。

【例】

127.0.0.1:6379> lpush list1 hello
(integer) 1

127.0.0.1:6379> lpush list1 world
(integer) 2

127.0.0.1:6379> lrange list1 0 -1
1) "world"
2) "hello"

③ rpush 方法（队列）

在 key 对应 list 的尾部 添加（压入）字符串元素。

【例】

127.0.0.1:6379> rpush list2 hello
(integer) 1

127.0.0.1:6379> rpush list2 world
(integer) 2

127.0.0.1:6379> lrange list2 0 -1
1) "hello"
2) "world"

不论是 lpush 还是 rpush 方法，都是从 list 的 两端压入。

④ linsert 方法

在 key 对应 list 的特定位置前或后添加字符串。

【例】

127.0.0.1:6379> rpush list3 one
(integer) 1

127.0.0.1:6379> linsert list3 before one two
(integer) 2

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "one"

127.0.0.1:6379> linsert list3 before one three
(integer) 3

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "three"
3) "one"

注意：

|   |　　头（前）

|   |　　↑

|   |　　尾

⑤ lset 方法

设置 list 中指定下标的元素值（替换指定下标的元素，类似 php 中的数组：$arr = array('a', 'b', 'c'); $arr[0] = 'd'; ）。

【例】

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "three"
3) "one"

127.0.0.1:6379> lset list3 1 tmp
ok

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "tmp"
3) "one"

127.0.0.1:6379> lset list3 0 reset
ok

127.0.0.1:6379> lrange list3 0 -1
1) "reset"
2) "tmp"
3) "one"

⑥ lrem 方法

从 key 对应 list 中删除 n 个和 value 相同的元素。（n < 0 从尾删除，n = 0 全部删除）。返回删除的个数。

【例】

127.0.0.1:6379> lrange list3 0 -1
1) "reset"
2) "tmp"
3) "one"

127.0.0.1:6379> lpush list3 two
(integer) 4
127.0.0.1:6379> lpush list3 two
(integer) 5
127.0.0.1:6379> lpush list3 two
(integer) 6

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "two"
3) "two"
4) "reset"
5) "tmp"
6) "one"

127.0.0.1:6379> lrem list3 1 two
(integer) 1

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "two"
3) "reset"
4) "tmp"
5) "one"

127.0.0.1:6379> rpush list3 two
(integer) 6

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "two"
3) "reset"
4) "tmp"
5) "one"
6) "two"

127.0.0.1:6379> lrem list3 -2 two
(integer) 2

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "reset"
3) "tmp"
4) "one"

【例2】

127.0.0.1:6379> lrange list3 0 -1
1) "two"
2) "reset"
3) "tmp"
4) "one"

127.0.0.1:6379> lrem list3 -2 two
(integer) 1

127.0.0.1:6379> lrange list3 0 -1
1) "reset"
2) "tmp"
3) "one"

127.0.0.1:6379> lrem list3 -2 two
(integer) 0

127.0.0.1:6379> lrange list3 0 -1
1) "reset"
2) "tmp"
3) "one"

⑦ ltrm 方法

保留指定 key  的值范围内的数据。

【例】

127.0.0.1:6379> lpush list4 one
(integer) 1
127.0.0.1:6379> lpush list4 two
(integer) 2
127.0.0.1:6379> lpush list4 three
(integer) 3
127.0.0.1:6379> lpush list4 four
(integer) 4

127.0.0.1:6379> lrange list4 0 -1
1) "four"
2) "three"
3) "two"
4) "one"

127.0.0.1:6379> ltrim list4 1 2
ok

127.0.0.1:6379> lrange list4 0 -1
1) "three"
2) "two"

说明：保留下标（key）为 1 开始到下标为 2 的元素，其他两端的元素全部删除。

【例2】

127.0.0.1:6379> lrange list4 0 -1
1) "seven"
2) "six"
3) "five"
4) "three"
5) "two"

127.0.0.1:6379> ltrim list4 2 -1
ok

127.0.0.1:6379> lrange list4 0 -1
1) "five"
2) "three"
3) "two"

⑧ lpop 方法

从 list 的头部 删除 元素，并返回删除的元素（类似 php 中的 array_pop() 方法：将数组的最后一个单元弹出（删除））。

（rpop：代表从尾部删除元素）

【例】

127.0.0.1:6379> lrange list4 0 -1
1) "five"
2) "three"
3) "two"

127.0.0.1:6379> lpop list4
"five"

127.0.0.1:6379> lrange list4 0 -1
1) "three"
2) "two"

127.0.0.1:6379> rpop list4
"two"

127.0.0.1:6379> lrange list4 0 -1
1) "three"

⑨ rpoplpush 方法

从第一个 list 的尾部移除元素并添加到 第二个 list 的头部。

127.0.0.1:6379> lrange list4 0 -1
1) "eight"
2) "seven"
3) "three"

127.0.0.1:6379> lrange list5 0 -1
1) "redis"
2) "nginx"
3) "mysql"
4) "php"

127.0.0.1:6379> rpoplpush list4 list5
"three"

127.0.0.1:6379> lrange list4 0 -1
1) "eight"
2) "seven"

127.0.0.1:6379> lrange list5 0 -1
1) "three"
2) "redis"
3) "nginx"
4) "mysql"
5) "php"

⑩ lindex 方法

返回名称为 key 的 list 中 index 位置的元素。

【例】

127.0.0.1:6379> lrange list5 0 -1
1) "three"
2) "redis"
3) "nginx"
4) "mysql"
5) "php"

127.0.0.1:6379> lindex list5 1
"redis"

127.0.0.1:6379> lindex list5 -1
"php"

⑪ llen 方法（类似 php 中 count($arr) ）

返回 list 链表中元素的个数。

【例】

127.0.0.1:6379> lrange list5 0 -1
1) "three"
2) "redis"
3) "nginx"
4) "mysql"
5) "php"
 
127.0.0.1:6379> llen list5
(integer) 5