Redis列表(list)命令详解

/ Redis / 0 条评论 / 452浏览

LPUSH

将一个或多个值 value 插入到列表 key 的表头。
如果有多个 value 值,那么各个 value 值按从左到右的顺序依次插入到表头: 比如说,对空列表 list 执行命令 LPUSH list 1 2 3 ,列表的值将是 3 2 1 ,这等同于原子性地执行 LPUSH list 1 、 LPUSH list 2 和 LPUSH list 3 三个命令。
如果 key 不存在,一个空列表会被创建并执行 LPUSH 操作。 当 key 存在但不是列表类型时,返回一个错误。

语法

LPUSH key value [value ...]

返回值:

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

实例:

127.0.0.1:6379> LPUSH list 1            #加入单个元素#
(integer) 1

127.0.0.1:6379> LPUSH list 1             #加入重复元素#
(integer) 2

127.0.0.1:6379> LPUSH list 2 3 4        #加入多个元素#
(integer) 5

LRANGE

Redis Lrange 返回列表中指定区间内的元素,区间以偏移量 START 和 STOP 指定。 其中 0 表示列表的第一个元素, 1 表示列表的第二个元素,以此类推。 你也可以使用负数下标,以 -1 表示列表的最后一个元素, -2 表示列表的倒数第二个元素,以此类推。

语法:

LRANGE key start stop

返回值:

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

实例:

127.0.0.1:6379> LRANGE list 0 -1        #返回开始到最后的元素#
1) "4"
2) "3"
3) "2"
4) "1"
5) "1"

127.0.0.1:6379> LRANGE list 0 1        #返回开始和第二个元素#
1) "4"
2) "3"

BLPOP

BLPOP 是列表的阻塞式(blocking)弹出原语。它是 LPOP 命令的阻塞版本,当给定列表内没有任何元素可供弹出的时候,连接将被 BLPOP 命令阻塞,直到等待超时或发现可弹出元素为止。当给定多个 key 参数时,按参数 key 的先后顺序依次检查各个列表,弹出第一个非空列表的头元素。
当 BLPOP 被调用时,如果给定 key 内至少有一个非空列表,那么弹出遇到的第一个非空列表的头元素,并和被弹出元素所属的列表的名字一起,组成结果返回给调用者。

语法:

BLPOP key [key ...] timeout

返回值:

如果列表为空,返回一个 nil 。 否则,返回一个含有两个元素的列表,第一个元素是被弹出元素所属的 key ,第二个元素是被弹出元素的值。

实例1

当存在多个给定 key 时, BLPOP 按给定 key 参数排列的先后顺序,依次检查各个列表。假设现在有 list1 、 list2 和 list3 三个列表,其中 list1 不存在, list2 和 list3 都持有非空列表,那么BLPOP list1 list2 list3 1 第一次执行会跳过list1,返回list2和list2被弹出的值,跳过list3。第二次执行会跳过list1,list2,返回list3和list3被弹出的值。第三次执行,会阻塞1秒,返回(nil)。

127.0.0.1:6379> DEL list1 list2 list3       #确保key都被删除#
(integer) 0
127.0.0.1:6379> LPUSH list2 1               #为list2添加一个值#
(integer) 1
127.0.0.1:6379> LPUSH list3 2               #为list3添加一个值#
(integer) 1
127.0.0.1:6379> BLPOP list1 list2 list3 1   #list1为空被跳过,弹出list2和第一个元素#
1) "list2"                                  #弹出元素所属的列表#
2) "1"                                      #弹出元素所属的值#
127.0.0.1:6379> BLPOP list1 list2 list3 1
1) "list3"                                  #第二次执行弹出的列表#
2) "2"
127.0.0.1:6379> BLPOP list1 list2 list3 1
(nil)                                       #列表为空,返回(nil)#
(1.05s)                                     #列表都为空,阻塞时间#

实例2:

如果所有给定 key 都不存在或包含空列表,那么 BLPOP 命令将阻塞连接,直到等待超时,或有另一个客户端对给定 key 的任意一个执行 LPUSH 或 RPUSH 命令为止。超时参数 timeout 接受一个以秒为单位的数字作为值。超时参数设为 0 表示阻塞时间可以无限期延长(block indefinitely) 。


BRPOP

BRPOP 是列表的阻塞式(blocking)弹出原语.当给定列表内没有任何元素可供弹出的时候,连接将被 BRPOP 命令阻塞,直到等待超时或发现可弹出元素为止。当给定多个 key 参数时,按参数 key 的先后顺序依次检查各个列表,弹出第一个非空列表的尾部元素。关于阻塞操作的更多信息,请查看 BLPOP 命令, BRPOP除了弹出元素的位置和 BLPOP 不同之外,其他表现一致。

语法:

BRPOP key [key ...] timeout

返回值:

假如在指定时间内没有任何元素被弹出,则返回一个 nil 和等待时长。 反之,返回一个含有两个元素的列表,第一个元素是被弹出元素所属的 key ,第二个元素是被弹出元素的值。

实例

127.0.0.1:6379> LPUSH list 1
(integer) 1
127.0.0.1:6379> LPUSH list 2
(integer) 2
127.0.0.1:6379> BRPOP list 10
1) "list"
2) "1"
127.0.0.1:6379> BRPOP list 10
1) "list"
2) "2"

BLPOP 和 BRPOP 的区别,如下图:


网站运行: