一步一步学习Redis——五大数据类型之列表（List）的相关命令 Redis

文章目录： 1.开篇
2.Redis列表（List）的相关命令
2.1 LPUSH命令
语法
返回值
2.2 LRANGE命令
语法
【一步一步学习Redis——五大数据类型之列表（List）的相关命令】返回值
2.3 LLEN命令
语法
返回值
2.4 LSET命令
语法
返回值
2.5 LINDEX命令
语法
返回值
2.6 LPUSHX命令
语法
返回值
2.7 LREM命令
语法
返回值
2.8 LPOP命令
语法
返回值
2.9 LINSERT命令
语法
返回值
2.10 LTRIM命令
语法
返回值
2.11 RPUSH命令
语法
返回值
2.12 RPUSHX命令
语法
返回值
2.13 RPOP命令
语法
返回值
2.14 RPOPLPUSH命令
语法
返回值
2.15 BLPOP命令
语法
返回值
2.16 BRPOP命令
语法
返回值
2.17 BRPOPLPUSH命令
语法
返回值
1.开篇

Redis列表是简单的字符串列表，按照插入顺序排序。你可以添加一个元素到列表的头部（左边）或者尾部（右边）
一个列表最多可以包含 232 - 1 个元素 (4294967295, 每个列表超过40亿个元素)。

2.Redis列表（List）的相关命令

序号	命令及描述
1	BLPOP key1 [key2] timeout 移出并获取列表的第一个元素，如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
2	BRPOP key1 [key2] timeout 移出并获取列表的最后一个元素，如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
3	BRPOPLPUSH source destination timeout 从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它；如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
4	LINDEX key index 通过索引获取列表中的元素
5	LINSERT key BEFORE丨AFTER pivot value 在列表的元素前或者后插入元素
6	LLEN key 获取列表长度
7	LPOP key 移出并获取列表的第一个元素
8	LPUSH key value1 [value2] 将一个或多个值插入到列表头部
9	LPUSHX key value 将一个值插入到已存在的列表头部
10	LRANGE key start stop 获取列表指定范围内的元素
11	LREM key count value 移除列表元素
12	LSET key index value 通过索引设置列表元素的值
13	LTRIM key start stop 对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。
14	RPOP key 移除列表的最后一个元素，返回值为移除的元素。
15	RPOPLPUSH source destination 移除列表的最后一个元素，并将该元素添加到另一个列表并返回
16	RPUSH key value1 [value2] 在列表中添加一个或多个值
17	RPUSHX key value 为已存在的列表添加值

2.1 LPUSH命令

Redis Lpush 命令将一个或多个值插入到列表头部。如果 key 不存在，一个空列表会被创建并执行 LPUSH 操作。当 key 存在但不是列表类型时，返回一个错误。
注意：在Redis 2.4版本以前的 LPUSH 命令，都只接受单个 value 值。
语法

redis 127.0.0.1:6379> LPUSH KEY_NAME VALUE1.. VALUEN

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

2.2 LRANGE命令

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

redis 127.0.0.1:6379> LRANGE KEY_NAME START END

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

2.3 LLEN命令

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

redis 127.0.0.1:6379> LLEN KEY_NAME

返回值
列表的长度。

文章图片

2.4 LSET命令

Redis Lset 通过索引来设置元素的值。
当索引参数超出范围，或对一个空列表进行 LSET 时，返回一个错误。
语法

redis 127.0.0.1:6379> LSET KEY_NAME INDEX VALUE

返回值
操作成功返回 ok ，否则返回错误信息。

2.5 LINDEX命令

Redis Lindex 命令用于通过索引获取列表中的元素。你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
语法

redis 127.0.0.1:6379> LINDEX KEY_NAME INDEX_POSITION

返回值
列表中下标为指定索引值的元素。如果指定索引值不在列表的区间范围内，返回 nil 。

文章图片

2.6 LPUSHX命令

Redis Lpushx 将一个值插入到已存在的列表头部，列表不存在时操作无效。
语法

redis 127.0.0.1:6379> LPUSHX KEY_NAME VALUE1.. VALUEN

返回值
LPUSHX 命令执行之后，列表的长度。

文章图片

2.7 LREM命令

Redis Lrem 根据参数 COUNT 的值，移除列表中与参数 VALUE 相等的元素。
COUNT 的值可以是以下几种：

count > 0 : 从表头开始向表尾搜索，移除与 VALUE 相等的元素，数量为 COUNT 。

count < 0 : 从表尾开始向表头搜索，移除与 VALUE 相等的元素，数量为 COUNT 的绝对值。

count = 0 : 移除表中所有与 VALUE 相等的值。

语法

redis 127.0.0.1:6379> LREM key count VALUE

返回值
被移除元素的数量。列表不存在时返回 0 。

文章图片

2.8 LPOP命令

Redis Lpop 命令用于移除并返回列表的第一个元素。
语法

redis 127.0.0.1:6379> Lpop KEY_NAME

返回值
列表的第一个元素。当列表 key 不存在时，返回 nil 。

文章图片

2.9 LINSERT命令

Redis Linsert 命令用于在列表的元素前或者后插入元素。当指定元素不存在于列表中时，不执行任何操作。
当列表不存在时，被视为空列表，不执行任何操作。
如果 key 不是列表类型，返回一个错误。
语法

redis 127.0.0.1:6379> LINSERT key BEFORE|AFTER pivot value

将值 value 插入到列表 key 当中，位于值 pivot 之前或之后。
返回值
如果命令执行成功，返回插入操作完成之后，列表的长度。如果没有找到指定元素，返回 -1 。如果 key 不存在或为空列表，返回 0 。

文章图片

2.10 LTRIM命令

Redis Ltrim 对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。
下标 0 表示列表的第一个元素，以 1 表示列表的第二个元素，以此类推。你也可以使用负数下标，以 -1 表示列表的最后一个元素， -2 表示列表的倒数第二个元素，以此类推。
语法

redis 127.0.0.1:6379> LTRIM KEY_NAME START STOP

返回值
命令执行成功时，返回 ok 。

文章图片

2.11 RPUSH命令

Redis Rpush 命令用于将一个或多个值插入到列表的尾部(最右边)。
如果列表不存在，一个空列表会被创建并执行 RPUSH 操作。当列表存在但不是列表类型时，返回一个错误。
注意：在 Redis 2.4 版本以前的 RPUSH 命令，都只接受单个 value 值。
语法

redis 127.0.0.1:6379> RPUSH KEY_NAME VALUE1..VALUEN

返回值
执行 RPUSH 操作后，列表的长度。

2.12 RPUSHX命令

Redis Rpushx 命令用于将一个值插入到已存在的列表尾部(最右边)。如果列表不存在，操作无效。
语法

redis 127.0.0.1:6379> RPUSHX KEY_NAME VALUE1..VALUEN

返回值
执行 Rpushx 操作后，列表的长度。

文章图片

2.13 RPOP命令

Redis Rpop 命令用于移除列表的最后一个元素，返回值为移除的元素。
语法

redis 127.0.0.1:6379> RPOP KEY_NAME

返回值
被移除的元素。当列表不存在时，返回 nil 。

文章图片

2.14 RPOPLPUSH命令

Redis Rpoplpush 命令用于移除列表的最后一个元素，并将该元素添加到另一个列表并返回。
语法

redis 127.0.0.1:6379> RPOPLPUSH SOURCE_KEY_NAME DESTINATION_KEY_NAME

返回值
被弹出的元素。

文章图片

2.15 BLPOP命令

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

redis 127.0.0.1:6379> BLPOP LIST1 LIST2 .. LISTN TIMEOUT

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

文章图片

2.16 BRPOP命令

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

redis 127.0.0.1:6379> BRPOP LIST1 LIST2 .. LISTN TIMEOUT

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

文章图片

2.17 BRPOPLPUSH命令

Redis Brpoplpush 命令从列表中取出最后一个元素，并插入到另外一个列表的头部；如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。
语法

redis 127.0.0.1:6379> BRPOPLPUSH LIST1 ANOTHER_LIST TIMEOUT

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