redis  list类型

一、查看list类型的命令

二、list命令具体解释

一、查看list类型的命令

1、在终端数据 help @list

127.0.0.1:6379>help @list

  BLPOP key [key ...] timeout

  summary: Remove and get the first element ina list, or block until one is ava

ilable

  since: 2.0.0

  BRPOP key [key ...] timeout

  summary: Remove and get the last element in alist, or block until one is avai

lable

  since: 2.0.0

  BRPOPLPUSH source destination timeout

  summary: Pop a value from a list, push it toanother list and return it; or bl

ockuntil one is available

  since: 2.2.0

  LINDEX key index

  summary: Get an element from a list by itsindex

  since: 1.0.0

……

二、list命令具体解释

头元素和尾元素

头元素指的是列表左端/前端第一个元素。尾元素指的是列表右端/后端第一个元素。

举个样例，列表list包括三个元素：x, y, z，当中x是头元素。而z则是尾元素。

空列表

指不包括不论什么元素的列表。Redis将不存在的key也视为空列表。

1、lpush

lpush key value [value ...]

将值value插入到列表key的表头。

假设key不存在。一个空列表会被创建并运行lpush操作。

当key存在但不是列表类型时，返回一个错误。

时间复杂度：

O(1)

返回值：

运行lpush命令后，表的长度。

Note

在Redis 2.3版本号曾经的lpush命令，都仅仅接受单个value值。

127.0.0.1:6379>lpush word d

(integer)1

127.0.0.1:6379>lpush word a

(integer)2

127.0.0.1:6379>lpush word b

(integer)3

127.0.0.1:6379>lrange word 0 -1  # 显示列表内全部元素

1)"b"

2)"a"

3)"d"

2、lpushx

lpushx key value

将值value插入到列表key的表头，当且仅当key存在而且是一个列表。

和lpush命令相反，当key不存在时。lpushx命令什么也不做。

时间复杂度：

O(1)

返回值：

lpushx命令运行之后。表的长度。

#情况1：对空列表运行lpushx

127.0.0.1:6379>llen greet    # greet是一个空列表

(integer)0

127.0.0.1:6379>lpushx greet "hello"  # 尝试lpushx。失败，由于列表为空

(integer)0

#情况2：对非空列表运行lpushx

127.0.0.1:6379>lpush greet "hello"   # 先用lpush创建一个有一个元素的列表

(integer)1

127.0.0.1:6379>lpushx greet "good morning"   #这次lpushx运行成功

(integer)2

127.0.0.1:6379>lrange greet 0 -1

1)"good morning"

2)"hello"

3、rpush

rpush key value [value ...]

将值value插入到列表key的表尾。

假设key不存在。一个空列表会被创建并运行rpush操作。

当key存在但不是列表类型时，返回一个错误。

时间复杂度：

O(1)

返回值：

运行rpush操作后，表的长度。

Note

在Redis 2.3版本号曾经的rpush命令，都仅仅接受单个value值。

127.0.0.1:6379>llen fp-language # 显示列表中的元素数量

(integer)0

127.0.0.1:6379>rpush fp-language lisp

(integer)1

127.0.0.1:6379>lrange fp-language 0 0   # 显示列表中的元素

1)"lisp"

127.0.0.1:6379>rpush fp-language scheme

(integer)2

127.0.0.1:6379>lrange fp-language 0 1   # 显示列表中的元素

1)"lisp"

2)"scheme"

4、rpushx

rpushx key value

将值value插入到列表key的表尾，当且仅当key存在而且是一个列表。

和rpush命令相反，当key不存在时。rpushx命令什么也不做。

时间复杂度：

O(1)

返回值：

rpushx命令运行之后，表的长度。

#情况1：key不存在

127.0.0.1:6379>llen greet

(integer)0

127.0.0.1:6379>rpushx greet "hello"  # 对不存在的key进行rpushx，PUSH失败。

(integer)0

#情况2：key存在且是一个非空列表

127.0.0.1:6379>rpush greet "hi"  # 先用rpush插入一个元素

(integer)1

127.0.0.1:6379>rpushx greet "hello"  # greet如今是一个列表类型。rpushx操作成功。

(integer)2

127.0.0.1:6379>lrange greet 0 -1

1)"hi"

2)"hello"

5、lpop

lpop key

移除并返回列表key的头元素。

时间复杂度：

O(1)

返回值：

列表的头元素。

当key不存在时，返回nil。

127.0.0.1:6379>llen course

(integer)0

127.0.0.1:6379>rpush course algorithm001

(integer)1

127.0.0.1:6379>rpush course c++101

(integer)2

127.0.0.1:6379>LPOP course  # 移除头元素

"algorithm001"

6、rpop

rpop key

移除并返回列表key的尾元素。

时间复杂度：

O(1)

返回值：

列表的尾元素。

当key不存在时，返回nil。

127.0.0.1:6379>rpush mylist "one"

(integer)1

127.0.0.1:6379>rpush mylist "two"

(integer)2

127.0.0.1:6379>rpush mylist "three"

(integer)3

127.0.0.1:6379>rpop mylist  # 返回被弹出的元素

"three"

127.0.0.1:6379>lrange mylist 0 -1   # 列表剩下的元素

1)"one"

2)"two"

7、rlpop

rlpopkey [key ...] timeout

rlpop是列表的堵塞式(blocking)弹出原语。

它是LPOP命令的堵塞版本号，当给定列表内没有不论什么元素可供弹出的时候，连接将被rlpop命令堵塞，直到等待超时或发现可弹出元素为止。

当给定多个key參数时，按參数key的先后顺序依次检查各个列表，弹出第一个非空列表的头元素。

非堵塞行为

当rlpop被调用时，假设给定key内至少有一个非空列表，那么弹出遇到的第一个非空列表的头元素，并和被弹出元素所属的列表的名字一起，组成结果返回给调用者。

当存在多个给定key时，rlpop按给定key參数排列的先后顺序，依次检查各个列表。

如果如今有job、 command和request三个列表。当中job不存在，command和request都持有非空列表。考虑下面命令：

rlpopjob command request 0

rlpop保证返回的元素来自command。由于它是按”查找job -> 查找command -> 查找request“这种顺序。第一个找到的非空列表。

127.0.0.1:6379>DEL job command request  # 确保key都被删除

(integer)0

127.0.0.1:6379>lpush command "update system..." # 为command列表添加一个值

(integer)1

127.0.0.1:6379>lpush request "visit page"  # 为request列表添加一个值

(integer)1

127.0.0.1:6379>rlpop job command request 0  # job列表为空。被跳过。紧接着command列表的第一个元素被弹出。

1)"command"    # 弹出元素所属的列表

2)"update system..."   # 弹出元素所属的值堵塞行为

假设全部给定key都不存在或包括空列表。那么rlpop命令将堵塞连接。直到等待超时。或有还有一个client对给定key的随意一个运行lpush或rpush命令为止。

超时參数timeout接受一个以秒为单位的数字作为值。超时參数设为0表示堵塞时间能够无限期延长(block indefinitely) 。

127.0.0.1:6379>EXISTS job  # 确保两个key都不存在

(integer)0

127.0.0.1:6379>EXISTS command

(integer)0

127.0.0.1:6379>rlpop job command 300  #由于key一開始不存在，所以操作会被堵塞，直到还有一client对job或者command列表进行PUSH操作。

1)"job"  # 这里被push的是job

2)"do my home work"  # 被弹出的值

(26.26s)  # 等待的秒数

127.0.0.1:6379>rlpop job command 5  # 等待超时的情况

(nil)

(5.66s)# 等待的秒数同样的key被多个client同一时候堵塞

同样的key能够被多个client同一时候堵塞。

不同的client被放进一个队列中，按”先堵塞先服务”(first-rlpop，first-served)的顺序为key运行rlpop命令。

在MULTI/EXEC事务中的rlpop

rlpop能够用于流水线(pipline,批量地发送多个命令并读入多个回复)。但把它用在MULTI/EXEC块其中没有意义。由于这要求整个server被堵塞以保证块运行时的原子性。该行为阻止了其它client运行lpush或rpush命令。

一个被包括在MULTI/EXEC块内的rlpop操作。行为表现得就像操作超时一样，只返回一个nil值。

假设你是科幻迷。你能够想象在MULTI/EXEC块内。时间以无限的速度在流逝。

127.0.0.1:6379>MULTI

OK

127.0.0.1:6379>rlpop job 30

QUEUED

127.0.0.1:6379>EXEC

1)(nil)  # 操作没有等待，马上被返回了时间复杂度：

O(1)

返回值：

假如在指定时间内没有不论什么元素被弹出，则返回一个nil和等待时长。

反之，返回一个含有两个元素的列表。第一个元素是被弹出元素所属的key，第二个元素是被弹出元素的值。

8、brpop

brpopkey [key ...] timeout

brpop是列表的堵塞式(blocking)弹出原语。

它是rpop命令的堵塞版本号，当给定列表内没有不论什么元素可供弹出的时候。连接将被brpop命令堵塞，直到等待超时或发现可弹出元素为止。

当给定多个key參数时，按參数key的先后顺序依次检查各个列表，弹出第一个非空列表的尾部元素。

关于堵塞操作的很多其它信息，请查看rlpop命令，brpop除了弹出元素的位置和rlpop不同之外。其它表现一致。

时间复杂度：

O(1)

返回值：

假如在指定时间内没有不论什么元素被弹出。则返回一个nil和等待时长。

反之。返回一个含有两个元素的列表，第一个元素是被弹出元素所属的key，第二个元素是被弹出元素的值。

127.0.0.1:6379>llen course

(integer)0

127.0.0.1:6379>rpush course algorithm001

(integer)1

127.0.0.1:6379>rpush course c++101  # 尾部元素

(integer)2

127.0.0.1:6379>brpop course 30

1)"course" # 弹出元素的key

2)"c++101" # 弹出元素的值

9、llen

llenkey

返回列表key的长度。

假设key不存在，则key被解释为一个空列表，返回0.

假设key不是列表类型，返回一个错误。

时间复杂度：

O(1)

返回值：

列表key的长度。

#情况1：空列表

127.0.0.1:6379>llen job

(integer)0

#情况2：非空列表

127.0.0.1:6379>lpush job "cook food"

(integer)1

127.0.0.1:6379>lpush job "have lunch"

(integer)2

127.0.0.1:6379>llen job

(integer)2

10、lrange

lrangekey start stop

返回列表key中指定区间内的元素，区间以偏移量start和stop指定。

下标(index)參数start和stop都以0为底，也就是说。以0表示列表的第一个元素。以1表示列表的第二个元素。以此类推。

你也能够使用负数下标，以-1表示列表的最后一个元素，-2表示列表的倒数第二个元素，以此类推。

注意lrange命令和编程语言区间函数的差别

假如你有一个包括一百个元素的列表，对该列表运行lrange list 0 10，结果是一个包括11个元素的列表，这表明stop下标也在lrange命令的取值范围之内(闭区间)。这和某些语言的区间函数可能不一致，比方Ruby的Range.new、Array#slice和Python的range()函数。

超出范围的下标

超出范围的下标值不会引起错误。

假设start下标比列表的最大下标end(llen list减去1)还要大，或者start > stop，lrange返回一个空列表。

假设stop下标比end下标还要大，Redis将stop的值设置为end。

时间复杂度:

O(S+N)，S为偏移量start。N为指定区间内元素的数量。

返回值:

一个列表，包括指定区间内的元素。

127.0.0.1:6379>rpush fp-language lisp   # 插入一个值到列表fp-language

(integer)1

127.0.0.1:6379>lrange fp-language 0 0

1)"lisp"

127.0.0.1:6379>rpush fp-language scheme

(integer)2

127.0.0.1:6379>lrange fp-language 0 1

1)"lisp"

2)"scheme"

11、lrem

lremkey count value

依据參数count的值。移除列表中与參数value相等的元素。

count的值能够是下面几种：

count> 0: 从表头開始向表尾搜索。移除与value相等的元素，数量为count。

count< 0: 从表尾開始向表头搜索，移除与value相等的元素。数量为count的绝对值。

count= 0: 移除表中全部与value相等的值。

时间复杂度：

O(N)，N为列表的长度。

返回值：

被移除元素的数量。

由于不存在的key被视作空表(empty list)。所以当key不存在时。lrem命令总是返回0。

#先创建一个表，内容排列是

#morning hello morning helllo morning

127.0.0.1:6379>lpush greet "morning"

(integer)1

127.0.0.1:6379>lpush greet "hello"

(integer)2

127.0.0.1:6379>lpush greet "morning"

(integer)3

127.0.0.1:6379>lpush greet "hello"

(integer)4

127.0.0.1:6379>lpush greet "morning"

(integer)5

127.0.0.1:6379>lrange greet 0 4 # 查看全部元素

1)"morning"

2)"hello"

3)"morning"

4)"hello"

5)"morning"

127.0.0.1:6379>lrem greet 2 morning  # 移除从表头到表尾，最先发现的两个morning

(integer)2  # 两个元素被移除

127.0.0.1:6379>llen greet   # 还剩3个元素

(integer)3

127.0.0.1:6379>lrange greet 0 2

1)"hello"

2)"hello"

3)"morning"

127.0.0.1:6379>lrem greet -1 morning  # 移除从表尾到表头，第一个morning

(integer)1

127.0.0.1:6379>llen greet

(integer)2

127.0.0.1:6379>lrange greet 0 1

1)"hello"

2)"hello"

127.0.0.1:6379>lrem greet 0 hello  # 移除表中全部hello

(integer)2  # 两个hello被移除

127.0.0.1:6379>llen greet

(integer)0

12、lset

lsetkey index value

将列表key下标为index的元素的值甚至为value。

很多其它信息请參考lindex操作。

当index參数超出范围时。返回一个错误。

时间复杂度：

对头元素或尾元素进行lset操作。复杂度为O(1)。

其它情况下。为O(N)。N为列表的长度。

返回值：

操作成功返回ok，否则返回错误信息。

127.0.0.1:6379>lpush job "cook food"

(integer)1

127.0.0.1:6379>lrange job 0 0

1)"cook food"

127.0.0.1:6379>lset job 0 "play game"

OK

127.0.0.1:6379>lrange job  0 0

1)"play game"

13、ltrim

ltrimkey start stop

对一个列表进行修剪(trim)，就是说，让列表仅仅保留指定区间内的元素，不在指定区间之内的元素都将被删除。

举个样例，运行命令ltrim list 0 2，表示仅仅保留列表list的前三个元素，其余元素所有删除。

下标(index)參数start和stop都以0为底，也就是说，以0表示列表的第一个元素，以1表示列表的第二个元素，以此类推。

你也能够使用负数下标。以-1表示列表的最后一个元素，-2表示列表的倒数第二个元素，以此类推。

当key不是列表类型时，返回一个错误。

ltrim命令通常和lpush命令或rpush命令配合使用。举个样例：

lpushlog newest_log

ltrimlog 0 99这个样例模拟了一个日志程序，每次将最新日志newest_log放到log列表中。而且仅仅保留最新的100项。

注意当这样使用ltrim命令时，时间复杂度是O(1)，由于平均情况下，每次仅仅有一个元素被移除。

注意ltrim命令和编程语言区间函数的差别

假如你有一个包括一百个元素的列表list，对该列表运行ltrim list 0 10。结果是一个包括11个元素的列表。这表明stop下标也在ltrim命令的取值范围之内(闭区间)，这和某些语言的区间函数可能不一致，比方Ruby的Range.new、Array#slice和Python的range()函数。

超出范围的下标

超出范围的下标值不会引起错误。

假设start下标比列表的最大下标end(llen list减去1)还要大，或者start > stop，ltrim返回一个空列表(由于ltrim已经将整个列表清空)。

假设stop下标比end下标还要大。Redis将stop的值设置为end。

时间复杂度:

O(N)。N为被移除的元素的数量。

返回值:

命令运行成功时，返回ok。

#情况1：普通情况下标

127.0.0.1:6379>lrange alpha 0 -1 # 建立一个5元素的列表

1)"h"

2)"e"

3)"l"

4)"l"

5)"o"

127.0.0.1:6379>ltrim alpha 1 -1  # 删除索引为0的元素

OK

127.0.0.1:6379>lrange alpha 0 -1 # "h"被删除

1)"e"

2)"l"

3)"l"

4)"o"

#情况2：stop下标比元素的最大下标要大

127.0.0.1:6379>ltrim alpha 1 10086

OK

127.0.0.1:6379>lrange alpha 0 -1

1)"l"

2)"l"

3)"o"

#情况3：start和stop下标都比最大下标要大，且start < sotp

127.0.0.1:6379>ltrim alpha 10086 200000

OK

127.0.0.1:6379>lrange alpha 0 -1 # 整个列表被清空，等同于DEL alpha

(emptylist or set)

#情况4：start > stop

127.0.0.1:6379>lrange alpha 0 -1 # 在新建一个列表

1)"h"

2)"u"

3)"a"

4)"n"

5)"g"

6)"z"

127.0.0.1:6379>ltrim alpha 10086 4

OK

127.0.0.1:6379>lrange alpha 0 -1 # 列表相同被清空

(emptylist or set)

14、lindex

lindexkey index

返回列表key中，下标为index的元素。

下标(index)參数start和stop都以0为底，也就是说。以0表示列表的第一个元素，以1表示列表的第二个元素，以此类推。

你也能够使用负数下标。以-1表示列表的最后一个元素，-2表示列表的倒数第二个元素，以此类推。

假设key不是列表类型，返回一个错误。

时间复杂度：

O(N)，N为到达下标index过程中经过的元素数量。

因此，对列表的头元素和尾元素运行lindex命令。复杂度为O(1)。

返回值:

列表中下标为index的元素。

假设index參数的值不在列表的区间范围内(out of range)。返回nil。

127.0.0.1:6379>lpush mylist "World"

(integer)1

127.0.0.1:6379>lpush mylist "Hello"

(integer)2

127.0.0.1:6379>lindex mylist 0

"Hello"

127.0.0.1:6379>lindex mylist -1

"World"

127.0.0.1:6379>lindex mylist 3  # index不在mylist的区间范围内

(nil)

15、linsert

linsertkey BEFORE|AFTER pivot value

将值value插入到列表key其中。位于值pivot之前或之后。

当pivot不存在于列表key时，不运行不论什么操作。

当key不存在时，key被视为空列表，不运行不论什么操作。

假设key不是列表类型，返回一个错误。

时间复杂度:

O(N)，N为寻找pivot过程中经过的元素数量。

返回值:

假设命令运行成功。返回插入操作完毕之后，列表的长度。

假设没有找到pivot。返回-1。

假设key不存在或为空列表，返回0。

127.0.0.1:6379>rpush mylist "Hello"

(integer)1

127.0.0.1:6379>rpush mylist "World"

(integer)2

127.0.0.1:6379>linsert mylist BEFORE "World" "There"

(integer)3

127.0.0.1:6379>lrange mylist 0 -1

1)"Hello"

2)"There"

3)"World"

127.0.0.1:6379>linsert mylist BEFORE "go" "let‘s"    # 对一个非空列表插入，查找一个不存在的pivot

(integer)-1    # 失败

127.0.0.1:6379>EXISTS fake_list  # 对一个空列表运行linsert命令

(integer)0

127.0.0.1:6379>linsert fake_list BEFORE "nono" "gogogog"

(integer)0 # 失败

16、rpoplpush

rpoplpushsource destination

命令rpoplpush在一个原子时间内，运行下面两个动作：

将列表source中的最后一个元素(尾元素)弹出。并返回给client。

将source弹出的元素插入到列表destination，作为destination列表的的头元素。

举个样例，你有两个列表source和destination，source列表有元素a, b, c，destination列表有元素x, y, z，运行rpoplpush source destination之后，source列表包括元素a, b。destination列表包括元素c, x, y, z 。而且元素c被返回。

假设source不存在，值nil被返回，而且不运行其它动作。

假设source和destination同样，则列表中的表尾元素被移动到表头。并返回该元素。能够把这样的特殊情况视作列表的旋转(rotation)操作。

时间复杂度：

O(1)

返回值：

假如在指定时间内没有不论什么元素被弹出，则返回一个nil和等待时长。

反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。

#相关数据

127.0.0.1:6379>rpush alpha a

(integer)1

127.0.0.1:6379>rpush alpha b

(integer)2

127.0.0.1:6379>rpush alpha c

(integer)3

127.0.0.1:6379>rpush alpha d

(integer)4

#情况1：source和destination不同

127.0.0.1:6379>lrange alpha 0 -1 # 查看全部元素

1)"a"

2)"b"

3)"c"

4)"d"

127.0.0.1:6379>rpoplpush alpha reciver   # 运行一次rpoplpush看看

"d"

127.0.0.1:6379>lrange alpha 0 -1

1)"a"

2)"b"

3)"c"

127.0.0.1:6379>lrange reciver 0 -1

1)"d"

#情况2：source和destination同样

127.0.0.1:6379>rpoplpush alpha alpha

"c"

127.0.0.1:6379>lrange alpha 0 -1 # 原来的尾元素"c"被放到了头部

1)"c"

2)"a"

3)"b"

设计模式：一个安全的队列

Redis的列表常常被用作队列(queue)。用于在不同程序之间有序地交换消息(message)。

一个程序(称之为生产者，producer)通过lpush命令将消息放入队列中。而还有一个程序(称之为消费者，consumer)通过rpop命令取出队列中等待时间最长的消息。

不幸的是，在这个过程中，一个消费者可能在获得一个消息之后崩溃，而未运行完毕的消息也因此丢失。

使用rpoplpush命令能够解决问题，由于它在返回一个消息之余，还将该消息加入到还有一个列表其中，另外的这个列表能够用作消息的备份表：假如一切正常，当消费者完毕该消息的处理之后，能够用lrem命令将该消息从备份表删除。

还有一方面，助手(helper)程序能够通过监视备份表，将超过一定处理时限的消息又一次放入队列中去(负责处理该消息的消费者可能已经崩溃)，这样就不会丢失不论什么消息了。

17、brpoplpush

brpoplpushsource destination timeout

brpoplpush是rpoplpush的堵塞版本号，当给定列表source不为空时。brpoplpush的表现和rpoplpush一样。

当列表source为空时，brpoplpush命令将堵塞连接，直到等待超时，或有还有一个client对source运行lpush或rpush命令为止。

超时參数timeout接受一个以秒为单位的数字作为值。

超时參数设为0表示堵塞时间能够无限期延长(block indefinitely) 。

很多其它相关信息，请參考rpoplpush命令。

时间复杂度：

O(1)

返回值：

假如在指定时间内没有不论什么元素被弹出，则返回一个nil和等待时长。

反之，返回一个含有两个元素的列表。第一个元素是被弹出元素的值。第二个元素是等待时长。

#情况1：非空列表

127.0.0.1:6379>brpoplpush msg reciver 500

"hellomoto"    # 弹出元素的值

(3.38s)         # 等待时长

127.0.0.1:6379>llen reciver

(integer)1

127.0.0.1:6379>lrange reciver 0 0

1)"hello moto"

#情况2：空列表

127.0.0.1:6379>brpoplpush msg reciver 1

(nil)

(1.34s)