文章目录:
![](/qrcode.jpg)
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 和等待时长。 反之,返回一个含有两个元素的列表,第一个元素是被弹出元素的值,第二个元素是等待时长。