1.BLPOP key [key ...] timeout

BLPOP 是列表的阻塞式(blocking)弹出原语。

它是 LPOP 命令的阻塞版本，当给定列表内没有任何元素可供弹出的时候，连接将被 BLPOP 命令阻塞，直到等待超时或发现可弹出元素为止。

当给定多个 key 参数时，按参数 key

非阻塞行为

当 BLPOP 被调用时，如果给定 key

当存在多个给定 key 时， BLPOP 按给定 key

假设现在有 job 、 command 和 request 三个列表，其中 job 不存在， command 和 request

BLPOP job command request 0

BLPOP 保证返回的元素来自 command ，因为它是按”查找 job -> 查找 command -> 查找 request

 

redis> DEL job command request           # 确保key都被删除
(integer) 0

redis> LPUSH command "update system..."  # 为command列表增加一个值
(integer) 1

redis> LPUSH request "visit page"        # 为request列表增加一个值
(integer) 1

redis> BLPOP job command request 0       # job 列表为空，被跳过，紧接着 command 列表的第一个元素被弹出。
1) "command"                             # 弹出元素所属的列表
2) "update system..."

 

阻塞行为

如果所有给定 key 都不存在或包含空列表，那么 BLPOP 命令将阻塞连接，直到等待超时，或有另一个客户端对给定 key

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

相同的key被多个客户端同时阻塞

相同的 key

不同的客户端被放进一个队列中，按『先阻塞先服务』(first-BLPOP，first-served)的顺序为 key

 

 

 

2.BRPOP key [key ...] timeout

BRPOP 是列表的阻塞式(blocking)弹出原语。

它是 RPOP 命令的阻塞版本，当给定列表内没有任何元素可供弹出的时候，连接将被 BRPOP 命令阻塞，直到等待超时或发现可弹出元素为止。

当给定多个 key 参数时，按参数 key

关于阻塞操作的更多信息，请查看 BLPOP 命令， BRPOP 除了弹出元素的位置和 BLPOP 不同之外，其他表现一致。

可用版本：

>= 2.0.0

时间复杂度：

O(1)

返回值：

假如在指定时间内没有任何元素被弹出，则返回一个 nil

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

 

 

 

3.LINDEX key index

返回列表 key 中，下标为 index

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

你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2

如果 key

可用版本：

>= 1.0.0

时间复杂度：

O(N)， N 为到达下标 index

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

返回值:

列表中下标为 index

如果 index 参数的值不在列表的区间范围内(out of range)，返回 nil

 

 

 

4.LINSERT key BEFORE|AFTER pivot value

将值 value 插入到列表 key 当中，位于值 pivot

当 pivot 不存在于列表 key

当 key 不存在时， key

如果 key

可用版本：

>= 2.2.0

时间复杂度:

O(N)， N 为寻找 pivot

返回值:

如果命令执行成功，返回插入操作完成之后，列表的长度。

如果没有找到 pivot ，返回 -1

如果 key 不存在或为空列表，返回 0

redis> RPUSH mylist "Hello"
(integer) 1

redis> RPUSH mylist "World"
(integer) 2

redis> LINSERT mylist BEFORE "World" "There"
(integer) 3

redis> LRANGE mylist 0 -1
1) "Hello"
2) "There"
3) "World"


# 对一个非空列表插入，查找一个不存在的 pivot

redis> LINSERT mylist BEFORE "go" "let's"
(integer) -1                                    # 失败


# 对一个空列表执行 LINSERT 命令

redis> EXISTS fake_list
(integer) 0

redis> LINSERT fake_list BEFORE "nono" "gogogog"
(integer) 0

 

 

5.LLEN key

返回列表 key

如果 key 不存在，则 key 被解释为一个空列表，返回 0

如果 key

可用版本：

>= 1.0.0

时间复杂度：

O(1)

返回值：

列表 key

 

6.LPOP key

移除并返回列表 key

可用版本：

>= 1.0.0

时间复杂度：

O(1)

返回值：

列表的头元素。

当 key 不存在时，返回 nil

 

  

7.LPUSH key value [value ...]

将一个或多个值 value 插入到列表 key

如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表头： 比如说，对空列表 mylist 执行命令 LPUSH mylist a bc ，列表的值将是 c b a ，这等同于原子性地执行 LPUSH mylist a 、 LPUSH mylist b 和 LPUSH mylist c

如果 key

当 key

在Redis 2.4版本以前的 LPUSH 命令，都只接受单个 value

可用版本：

>= 1.0.0

时间复杂度：

O(1)

返回值：

执行 LPUSH 命令后，列表的长度。

8.LPUSHX key value

将值 value 插入到列表 key 的表头，当且仅当 key

和 LPUSH 命令相反，当 key

可用版本：

>= 2.2.0

时间复杂度：

O(1)

返回值：

LPUSHX 命令执行之后，表的长度。

# 对空列表执行 LPUSHX

redis> LLEN greet                       # greet 是一个空列表
(integer) 0

redis> LPUSHX greet "hello"             # 尝试 LPUSHX，失败，因为列表为空
(integer) 0


# 对非空列表执行 LPUSHX

redis> LPUSH greet "hello"              # 先用 LPUSH 创建一个有一个元素的列表
(integer) 1

redis> LPUSHX greet "good morning"      # 这次 LPUSHX 执行成功
(integer) 2

redis> LRANGE greet 0 -1
1) "good morning"
2) "hello"
indexnext |previous |

 

 

9.LRANGE key 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

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

可用版本：

>= 1.0.0

时间复杂度:

O(S+N)， S 为偏移量 start ， N

返回值:

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

 

10.LREM key count value

根据参数 count 的值，移除列表中与参数 value

count

  • count > 0 : 从表头开始向表尾搜索，移除与 value 相等的元素，数量为 count
  • count < 0 : 从表尾开始向表头搜索，移除与 value 相等的元素，数量为 count
  • count = 0 : 移除表中所有与 value

可用版本：

>= 1.0.0

时间复杂度：

O(N)， N

返回值：

被移除元素的数量。

因为不存在的 key 被视作空表(empty list)，所以当 key 不存在时， LREM 命令总是返回 0

 

 

11.LSET key index value

将列表 key 下标为 index 的元素的值设置为 value

当 index 参数超出范围，或对一个空列表( key

关于列表下标的更多信息，请参考 LINDEX 命令。

可用版本：

>= 1.0.0

时间复杂度：

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

其他情况下，为 O(N)， N

返回值：

操作成功返回 ok

 

 

12.LTRIM key start stop

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

举个例子，执行命令 LTRIM list 0 2 ，表示只保留列表 list

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

你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2

当 key

LTRIM 命令通常和 LPUSH 命令或 RPUSH 命令配合使用，举个例子：

LPUSH log newest_log
LTRIM log 0 99

这个例子模拟了一个日志程序，每次将最新日志 newest_log 放到 log 列表中，并且只保留最新的 100 项。注意当这样使用 LTRIM

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

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

超出范围的下标

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

如果 start 下标比列表的最大下标 end ( LLEN list 减去 1 )还要大，或者 start > stop

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

可用版本：

>= 1.0.0

时间复杂度:

O(N)， N

返回值:

命令执行成功时，返回 ok

 

 

 

 

13.RPOP key

移除并返回列表 key

可用版本：

>= 1.0.0

时间复杂度：

O(1)

返回值：

列表的尾元素。

当 key 不存在时，返回 nil

 

 

14.RPUSH key value [value ...]

将一个或多个值 value 插入到列表 key

如果有多个 value 值，那么各个 value 值按从左到右的顺序依次插入到表尾：比如对一个空列表 mylist 执行 RPUSH mylist a b c ，得出的结果列表为 a b c ，等同于执行命令 RPUSH mylist a 、 RPUSH mylist b 、 RPUSH mylist c

如果 key

当 key

在 Redis 2.4 版本以前的 RPUSH 命令，都只接受单个 value

可用版本：

>= 1.0.0

时间复杂度：

O(1)

返回值：

执行 RPUSH 操作后，表的长度。

 

15.RPUSHX key value

将值 value 插入到列表 key 的表尾，当且仅当 key

和 RPUSH 命令相反，当 key

可用版本：

>= 2.2.0

时间复杂度：

O(1)

返回值：

RPUSHX 命令执行之后，表的长度。