Redis 笔记与总结3 list 类型

redis 版本

[root@localhost ~]# redis-server --version
Redis server v=2.8. sha=: malloc=jemalloc-3.6. bits= 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:> lpush list1 hello
(integer) 1

127.0.0.1:> lpush list1 world
(integer) 2

127.0.0.1:> lrange list1  -
) "world"
) "hello"

③ rpush 方法（队列）

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

【例】

127.0.0.1:> rpush list2 hello
(integer) 1

127.0.0.1:> rpush list2 world
(integer) 2

127.0.0.1:> lrange list2  -
) "hello"
) "world"

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

④ linsert 方法

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

【例】

127.0.0.1:> rpush list3 one
(integer) 

127.0.0.1:> linsert list3 before one two
(integer) 

127.0.0.1:> lrange list3  -
) "two"
) "one"

127.0.0.1:> linsert list3 before one three
(integer) 

127.0.0.1:> lrange list3  -
) "two"
) "three"
) "one"

注意：

|   |　　头（前）

|   |　　↑

|   |　　尾

⑤ lset 方法

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

【例】

127.0.0.1:> lrange list3  -
) "two"
) "three"
) "one"

127.0.0.1:> lset list3  tmp
OK
127.0.0.1:> lrange list3  -
) "two"
) "tmp"
) "one"

127.0.0.1:> lset list3  reset
OK
127.0.0.1:> lrange list3  -
) "reset"
) "tmp"
) "one"

⑥ lrem 方法

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

【例】

127.0.0.1:> lrange list3  -
) "reset"
) "tmp"
) "one"

127.0.0.1:> lpush list3 two
(integer)
127.0.0.1:> lpush list3 two
(integer)
127.0.0.1:> lpush list3 two
(integer) 6

127.0.0.1:> lrange list3  -
) "two"
) "two"
) "two"
) "reset"
) "tmp"
) "one"

127.0.0.1:> lrem list3  two
(integer) 1

127.0.0.1:> lrange list3  -
) "two"
) "two"
) "reset"
) "tmp"
) "one"

127.0.0.1:> rpush list3 two
(integer) 6

127.0.0.1:> lrange list3  -
) "two"
) "two"
) "reset"
) "tmp"
) "one"
) "two"

127.0.0.1:> lrem list3 - two
(integer) 2

127.0.0.1:> lrange list3  -
) "two"
) "reset"
) "tmp"
) "one"

【例2】

127.0.0.1:> lrange list3  -
) "two"
) "reset"
) "tmp"
) "one"

127.0.0.1:> lrem list3 - two
(integer) 1

127.0.0.1:> lrange list3  -
) "reset"
) "tmp"
) "one"

127.0.0.1:> lrem list3 - two
(integer) 0

127.0.0.1:> lrange list3  -
) "reset"
) "tmp"
) "one"

⑦ ltrm 方法

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

【例】

127.0.0.1:> lpush list4 one
(integer)
127.0.0.1:> lpush list4 two
(integer)
127.0.0.1:> lpush list4 three
(integer)
127.0.0.1:> lpush list4 four
(integer)

127.0.0.1:> lrange list4  -
) "four"
) "three"
) "two"
) "one"

127.0.0.1:> ltrim list4
OK
127.0.0.1:> lrange list4  -
) "three"
) "two"

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

【例2】

127.0.0.1:> lrange list4  -
) "seven"
) "six"
) "five"
) "three"
) "two"

127.0.0.1:> ltrim list4  -
OK
127.0.0.1:> lrange list4  -
) "five"
) "three"
) "two"

⑧ lpop 方法

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

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

【例】

127.0.0.1:> lrange list4  -
) "five"
) "three"
) "two"

127.0.0.1:> lpop list4
"five"

127.0.0.1:> lrange list4  -
) "three"
) "two"

127.0.0.1:> rpop list4
"two"

127.0.0.1:> lrange list4  -
) "three"

⑨ rpoplpush 方法

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

127.0.0.1:> lrange list4  -
) "eight"
) "seven"
) "three"

127.0.0.1:> lrange list5  -
) "redis"
) "nginx"
) "mysql"
) "php"

127.0.0.1:> rpoplpush list4 list5
"three"

127.0.0.1:> lrange list4  -
) "eight"
) "seven"

127.0.0.1:> lrange list5  -
) "three"
) "redis"
) "nginx"
) "mysql"
) "php"

⑩ lindex 方法

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

【例】

127.0.0.1:> lrange list5  -
) "three"
) "redis"
) "nginx"
) "mysql"
) "php"

127.0.0.1:> lindex list5
"redis"

127.0.0.1:> lindex list5 -
"php"

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

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

【例】

127.0.0.1:> lrange list5  -
) "three"
) "redis"
) "nginx"
) "mysql"
) "php"

127.0.0.1:> llen list5
(integer)