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