Redis数据类型之列表List

Redis列表简介

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

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

Redis列表命令

一、BLPOP key1 [key2] timeout

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

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

二、BRPOP key1 [key2] timeout

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

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

三、BRPOPLPUSH source destination timeout

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

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

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

四、LINDEX key index

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

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

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

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

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

五、LINSERT key BEFORE|AFTER pivot value

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

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

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

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

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

六、LLEN key

作用：获取列表的长度。

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

七、LPOP key

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

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

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

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

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

九、LPUSHX key value

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

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

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

十、LRANGE key start stop

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

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

作用：移出列表元素

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

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

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

当列表不存在时，返回0

十二、LSET key index value

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

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

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

十三、LTRIM key start stop

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

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

十四、RPOP key

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

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

十五、RPOPLPUSH source destination

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

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

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

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

十七、RPUSHX key value

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

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