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

文章目录:

1.开篇

2.Redis列表(List)的相关命令 

2.1 LPUSH命令

语法

返回值

2.2 LRANGE命令

语法

返回值

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 和等待时长。 反之,返回一个含有两个元素的列表,第一个元素是被弹出元素的值,第二个元素是等待时长。

猜你喜欢

转载自blog.csdn.net/weixin_43823808/article/details/113768399