Redis之List命令

Redis之List命令

注：本文基于Linux系统上Redis v5.0.7进行讲解

1.lindex

命令用于通过索引获取列表中的元素;
你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推;
返回列表中下标为指定索引值的元素；
如果指定索引值不在列表的区间范围内，返回 nil

LINDEX KEY_NAME INDEX_POSITION

2.rpoplpush

用于移除列表的最后一个元素，并将该元素添加到另一个列表的首部；
返回被弹出的元素；
如果指定要移除的列表不存在，则返回nil；
如果“另一个列表不存在”，则新创建一个

 RPOPLPUSH SOURCE_KEY_NAME DESTINATION_KEY_NAME

3.blpop

命令移出并获取列表的第一个元素，;
如果列表没有元素会阻塞列表直到等待超过timeout时或发现可弹出元素为止，timeout单位是秒,;
超时后，说明列表为空，返回一个 nil跟时间 ;
没有超时，说明列表不为空，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。
注：TIMEOUT是必须要填的，不是选填

BLPOP LIST1 LIST2 .. LISTN TIMEOUT

在以上实例中，操作会被阻塞，在等待20秒后会返回 nil

4.brpop

命令移出并获取列表的最后一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止

BRPOP LIST1 LIST2 .. LISTN TIMEOUT

5.brpoplpush

命令从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它； 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止;
假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长；
反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长(注意：如果时间短立马可以获得到的话，只会返回一个元素即被弹出元素的值)

BRPOPLPUSH LIST1 ANOTHER_LIST TIMEOUT

6.lrem

根据参数 COUNT 的值，移除列表中与参数 VALUE 相等的元素;
COUNT 的值可以是以下几种：
count > 0 : 从表头开始向表尾搜索，移除与 VALUE 相等的元素，数量为 COUNT
count < 0 : 从表尾开始向表头搜索，移除与 VALUE 相等的元素，数量为 COUNT 的绝对值
count = 0 : 移除表中所有与 VALUE 相等的值
返回被移除元素的数量， 列表不存在时或者表中没有相同元素时返回 0

REM KEY_NAME COUNT VALUE

7.ltrim

一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除；
下标 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推；
你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推；
命令执行成功时，返回 ok

LTRIM KEY_NAME START STOP

8.lpushx

将一个或多个值插入到已存在的列表头部，列表不存在时操作无效;
返回LPUSHX 命令执行之后，列表的新长度；
列表不存在时或者对已经没有元素的列表操作时返回0

LPUSHX KEY_NAME VALUE1.. VALUEN

9.linsert

命令用于在列表的元素前或者后插入元素。;
当指定元素不存在于列表中时，不执行任何操作;
当列表不存在时，被视为空列表，不执行任何操作;
如果 key 不是列表类型，返回一个错误;
如果命令执行成功，返回插入操作完成之后，列表的新长度；
如果没有找到指定元素 ，返回 -1 ；
如果 key 不存在或为空列表，返回 0

LINSERT KEY_NAME BEFORE EXISTING_VALUE NEW_VALUE 

10.lset

通过索引来设置元素的值;
操作成功返回 ok ;
当索引参数超出范围，返回一个错误；
对一个空列表进行 LSET 时或者key不存在时返回错误信息

LSET KEY_NAME INDEX VALUE

11.rpushx

将一个或多个值插入到已存在的列表尾部(最右边);
执行 Rpushx 操作后，列表的新长度；
如果列表不存在，操作无效

RPUSHX KEY_NAME VALUE1..VALUEN

12.llen

命令用于返回列表的长度；
如果列表 key 不存在，则 key 被解释为一个空列表，返回 0 ;
如果 key 不是列表类型，返回一个错误

LLEN KEY_NAME