Redis列表简介

Redis列表是简单的字符串列表,一个列表最多可以包含 232 - 1 个元素。列表按照插入顺序排序,可以从列表的头部或者尾部添加元素

Redis数据类型之列表List_字符串

上图演示了使用LPUSH向列表中插入元素,并用LRANGE取出列表元素。LPUSH key value : 将元素从列表的头部插入

Redis列表命令

 一、BLPOP key1 [key2] timeout

作用: 移除并获取列表的第一个元素,如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止

Redis数据类型之列表List_source_02

返回值:在列表不为空时,返回两个元素,第一个是被弹出元素所属的key,第二个是被弹出的元素;列表为空时,在等待给定的timeout过后,会返回nil

 

二、BRPOP key1 [key2] timeout

作用:与BLPOP指令相反,移除并获取列表的最后一个元素,如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止

Redis数据类型之列表List_source_03

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

 

三、BRPOPLPUSH source destination timeout

作用:从列表中弹出一个值,将弹出的元素插入到另外一个列表中并返回,如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止

Redis数据类型之列表List_字符串_04

当被弹出元素的列表不为空时,BRPOPLPUSH会将列表的右边的第一个元素弹出,并插入到一个指定的列表中

Redis数据类型之列表List_元素_05

当列表为空时,超过指定时间,返回nil和等待时间

 

四、LINDEX key index

作用:通过索引获取列表中的元素。列表索引从0开始,也可以用负数表示,-1表示列表的最后一个元素

Redis数据类型之列表List_source_06

使用LPUSH向列表中插入2个元素,由于是从左边顺序插入,所以最后插入的就是左边第一个元素

LINDEX myList 0 : 获取myList的第一个元素,即"Hello"

LINDEX myList -1 : 从右边开始获取第一个元素,即"World"

LINDEX myList 3 : 超出索引范围,返回nil

 

五、LINSERT key BEFORE|AFTER pivot value

作用:在列表的元素前或者后插入元素。当指定元素不存在列表中,不执行任何操作;当列表不存在时,不执行任何操作;若key不是列表类型,返回错误

Redis数据类型之列表List_source_07

以上演示了向列表myList的元素"Hello"与"World"之间插入一个"PHP"

Redis数据类型之列表List_字符串_08

当想要在myList列表中不存在的元素"Python"后插入"JAVA",命令执行失败,返回-1

Redis数据类型之列表List_source_09

当列表不存在或为空时,进行LINSERT操作,命令执行失败,返回0

返回值:命令执行成功,返回插入元素之后的列表的长度;没找互指定元素,返回-1;key不存在或为空列表,返回0

 

六、LLEN key

作用:获取列表的长度。

Redis数据类型之列表List_元素_10

返回值:如果key不存在,则会被当成一个空列表,返回0;如果key不是列表类型,返回错误

 

七、LPOP key

作用:移出并获取列表的第一个元素

Redis数据类型之列表List_元素_11

返回值:执行成功,返回列表的第一个元素,key不存在时,返回nil

 

八、LPUSH key value1......valuen

作用:将一个或多个值插入到列表头部

Redis数据类型之列表List_元素_12

返回值:LPUSH命令执行成功后,返回此时列表的长度;如果key不存在,一个空列表将会被创建并执行LPUSH操作;如果key存在,但不是列表类型,返回错误

 

九、LPUSHX key value

作用:将一个或多个值插入到已存在的列表头部,列表不存在时操作无效

Redis数据类型之列表List_元素_13

操作执行成功时,返回此时列表的长度

Redis数据类型之列表List_source_14

当操作一个不存在的列表时,操作无效,返回0

 

十、LRANGE key start stop

作用:获取列表指定范围内的元素

Redis数据类型之列表List_source_15

start:从0开始,0表示左边第一个元素,以此类推

stop:若为正数,则含义与start相同;若为负数,则表示从右边数起,如-1表示右边起第一个元素,-2表示右边起第二个元素,以此类推

LRANGE list3 0 -1:表示从左边第一个元素开始取到右边第一个元素,也就是取出整个列表的元素

LRANGE list3 0 1:从左边第一个元素取到第二个元素

LRANGE list3 0 0:从第一个元素取到第一个元素,即第一个元素本身

注意:[start, stop]是闭区间

 

十一、LREM key count value

作用:移出列表元素

Redis数据类型之列表List_元素_16

当count=0时;移出key中所有与value相等的值,返回移出元素的数量

当count>0时;从列表左边开始,移出数量为count的与value相等的值

当count<0时;从右边开始,移出数量为count的绝对值的与value相等的值

当列表不存在时,返回0

 

十二、LSET key index value

作用:通过索引设置列表元素的值

Redis数据类型之列表List_字符串_17

使用LSET操作,索引上的新值将会替换旧值

Redis数据类型之列表List_字符串_18

当LSET操作超出索引范围时,将报索引参数超出范围错误;操作一个不存在的列表时,报"no such key"错误

 

十三、LTRIM key start stop

作用:删除列表中不在指定区间内的元素

Redis数据类型之列表List_字符串_19

LTRIM将列表中不在区间[start, stop]中的元素删除,操作成功返回ok

 

十四、RPOP key

作用:移出并获取列表的最后一个元素

Redis数据类型之列表List_字符串_20

RPOP删除列表的最后一个元素,操作成功返回被删除的元素;当操作一个不存在的列表时,返回nil

 

十五、RPOPLPUSH source destination

作用:移出列表的最后一个元素,并将该元素插入到另一个列表中

Redis数据类型之列表List_source_21

操作成功,返回被移出的元素

 

十六、RPUSH key value1......valuen

作用:从列表的右边插入一个或多个元素

Redis数据类型之列表List_source_22

 

十七、RPUSHX key value

作用:从右边向一个已存在的列表插入元素

Redis数据类型之列表List_字符串_23

操作成功返回此时列表的长度;操作一个不存在的列表时,返回0