Redis列表操作汇总（17个，附带实例）

列表是简单的字符串列表，其元素按照插入顺序排序。列表中可以添加一个元素到其头部（最左边）或者尾部（最右边）。

一个列表最多可以包含 2^32-1 个元素。

Redis列表基本操作

1) 在列表中添加一个或多个值

RPUSH 命令的作用是将一个或多个值插入到列表的尾部（最右边）。

如果列表不存在，那么 Redis 会创建一个空列表并执行 rpush 命令。当列表名称存在，但不是列表类型时，则返回一个错误。

RPUSH 命令的语法格式为：

RPUSH key_name value1 … valuen

RPUSH 命令返回列表的长度。

实例：

127.0.0.1:6379> RPUSH mylist "hello" # 将hello插入列表的最右端
(integer) 1
127.0.0.1:6379> RPUSH mylist "foo" # 将foo插入列表的最右端
(integer) 2
127.0.0.1:6379> RPUSH mylist "bar" # 将bar插入列表的最右端
(integer) 3
127.0.0.1:6379> LRANGE mylist 0 – 1 # 显示列表中所有元素
"hello"
"foo"
"bar"

2) 为已存在的列表添加值

RPUSHX 命令的作用是将一个或多个值插入已存在列表的尾部（最右边）。如果列表不存在，则此命令无效。

RPUSHX 命令的语法格式如下：

RPUSHX key_name value1 … valuen。

RPUSHX 命令返回列表的长度。

实例：

127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 2
127.0.0.1:6379> RPUSHX mylist2 "bar"
(integer) 0
127.0.0.1:6379> LRANGE mylist 0 -1
"hello"
"foo"

3) 将一个或多个值插入列表头部

LPUSH 命令的作用是将一个或多个值插入列表头部。如果 key 不存在，则Redis会创建一个空列表并执行 LPUSH 命令。当 key 存在但不是列表类型时，返回一个错误。

LPUSH 命令的语法格式如下：

LPUSH key_name value1 … valuen。

LPUSH 命令返回列表的长度。

实例：

127.0.0.1:6379> LPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> LPUSH list1 "bar"
(integer) 2
127.0.0.1:6379> LRANGE list1 0 -1
"foo"
"bar

4) 通过索引获取列表中的元素

LINDEX 命令的作用是通过索引来获取列表中的元素。使用时可以用负数表示下标，用 -1 表示列表的最后一个元素，-2 表示列表的倒数第二个元素，依次类推。

LINDEX 命令的语法格式如下：

LINDEX key_name index_position

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

实例：

127.0.0.1:6379> LPUSH mylist "World"
(integer) 1
127.0.0.1:6379> LPUSH mylist "Hello"
(integer) 2
127.0.0.1:6379> LINDEX mylist 0
"Hello"
127.0.0.1:6379> LINDEX mylist -1
"World"
127.0.0.1:6379> LINDEX mylist 3        # index不在 mylist 的区间范围内
(nil)

5) 获取列表指定范围内的元素

LRANGE 命令的作用是返回列表中指定区间内的元素，区间以偏移量通过 START 参数和 END 参数来指定，其中，0 表示列表的第一个元素，1 表示列表的第二个元素，依次类推。

使用 LRANGE 命令时也可以负数表示下标，用 -1 表示列表的最后一个元素，-2 表示列表的倒数第二个元素，依次类推。

LRANGE 命令的语法格式如下：

LRANGE key_name START END

LRANGE 命令返回一个列表，其中包含指定区间内的元素。

实例：

127.0.0.1:6379> LPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> LPUSH list1 "bar"
(integer) 2
127.0.0.1:6379> LPUSHX list1 "bar"
(integer) 0
127.0.0.1:6379> LRANGE list1 0 -1
"bar"
"bar"
"foo"

6) 移除列表的最后一个元素，将该元素添加到另一个列表中并返回

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

RPOPLPUSH 命令的语法格式如下：

RPOPLPUSH source_key_name destination_key_name

RPOPLPUSH 命令返回被弹出的元素。

实例：

127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 2
127.0.0.1:6379> RPUSH mylist "bar"
(integer) 3
127.0.0.1:6379> RPOPLPUSH mylist myotherlist
"bar"
127.0.0.1:6379> LRANGE mylist 0 -1
"hello"
"foo"

7) 移出并获取列表的第一个元素

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

BLPOP 命令的语法格式如下：

BLPOP list1 list2 … listn timeout

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

实例：

127.0.0.1:6379> BLPOP list1 100
# 在以上实例中，操作会被阻塞，如果指定的列表 key list1 存在数据则会返回第一个元素，否则在等待
# 100 s后返回nil。
(nil)
(100.06s)

8) 移出并获取列表的最后一个元素

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

BRPOP 命令的语法格式如下：

BRPOP list1 list2 … listn timeout

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

实例：

127.0.0.1:6379> BRPOP list1 100
# 在以上实例中，操作会被阻塞，如果指定的列表 key list1 存在数据则会返回第一个元素，否则在等待
# 100秒后会返回 nil 。
(nil)
(100.06s)

9) 从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回该元素

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

BRPOPLPUSH 命令的语法格式如下：

BRPOPLPUSH list1 another_list timeout

实例：

# 非空列表
127.0.0.1:6379> BRPOPLPUSH msg reciver 500
"hello moto"                        # 弹出元素的值
(3.38s)                             # 等待时长
127.0.0.1:6379> LLEN reciver
(integer) 1
127.0.0.1:6379> LRANGE reciver 0 0
"hello moto"
# 空列表
127.0.0.1:6379> BRPOPLPUSH msg reciver 1
(nil)
(1.34s)
<pre>
(nil)
(100.06s)

10) 移除列表中的元素

LREM 命令的作用是根据 COUNT 参数的值，移除列表中与 VALUE 参数相等的元素。

LREM 命令的语法格式如下：

LREM key_name COUNT VALUE

LREM 命令返回被移除元素的数量。当列表不存在时返回 0。

COUNT 的值可以是以下几种：

• COUNT值>0：从表头开始向表尾搜索，移除列表中与 VALUE 参数相等的元素，数量为 COUNT；
• COUNT值<0：从表尾开始向表头搜索，移除列表中与 VALUE 参数相等的元素，数量为 COUNT 的绝对值；
• COUNT值=0：移除表中所有与 VALUE 参数相等的元素。

实例：

127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 4
127.0.0.1:6379> LREM mylist -2 "hello"
(integer) 2

11) 获取列表长度

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

LLEN 命令的语法格式如下：

LLEN key_name

LLEN 命令返回列表的长度。

实例：

127.0.0.1:6379> RPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> RPUSH list1 "bar"
(integer) 2
127.0.0.1:6379> LLEN list1
(integer) 2

12) 对一个列表进行修剪

LTRIM 命令的作用是对一个列表进行修剪，也就是说，让列表只保留指定区间内的元素，不在指定区间内的元素都将被删除。

下标 0 表示列表的第一个元素，下标 1 表示列表的第二个元素，依次类推。读者也可以使用负数下标，用 -1 表示列表的最后一个元素，-2 表示列表的倒数第二个元素，依次类推。

LTRIM 命令的语法格式如下：

LTRIM key_name start stop

命令执行成功时，LTRIM 命令返回 OK。

实例：

127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
127.0.0.1:6379> RPUSH mylist "bar"
(integer) 4
127.0.0.1:6379> LTRIM mylist 1 -1
OK
127.0.0.1:6379> LRANGE mylist 0 -1
"hello"
"foo"
"bar"

13) 弹出列表的第一个元素并返回该值

LPOP 命令的作用是移除并返回列表的第一个元素。

LPOP 命令的语法格式如下：

LPOP listname

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

实例：

127.0.0.1:6379> RPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> RPUSH list1 "bar"
(integer) 2
127.0.0.1:6379> LPOP list1
"foo"

14) 将一个或多个元素插入已存在列表的头部

LPUSHX 命令的作用是将一个或多个值插入到已存在的列表头部。当列表不存在时，该命令无效。

LPUSHX 命令的语法格式如下：

LPUSHX key_name value1 … valuen

LPUSHX 命令返回列表的长度。

实例：

127.0.0.1:6379> LPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> LPUSHX list1 "bar"
(integer) 2
127.0.0.1:6379> LPUSHX list2 "bar"
(integer) 0
127.0.0.1:6379> LRANGE list1 0 -1
"foo"
"bar"

15) 在列表的指定元素前或者后插入元素

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

LINSERT 命令的语法格式如下：

LINSERT key_name BEFORE existing_value new_value

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

实例：

127.0.0.1:6379> RPUSH list1 "foo"
(integer) 1
127.0.0.1:6379> RPUSH list1 "bar"
(integer) 2
127.0.0.1:6379> LINSERT list1 BEFORE "bar" "Yes"
(integer) 3
127.0.0.1:6379> LRANGE mylist 0 -1
"foo"
"Yes"
"bar"

16) 移除并获取列表最后一个元素

RPOP 命令的作用是移除列表的最后一个元素，并返回该元素的值。

RPOP 命令的语法格式如下：

RPOP key_name

RPOP 命令返回列表的最后一个元素。当列表不存在时，返回 nil。

实例：

127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
127.0.0.1:6379> RPUSH mylist "bar"
(integer) 4
127.0.0.1:6379> RPOP mylist
OK
127.0.0.1:6379> LRANGE mylist 0 -1
"hello"
"hello"
"foo"

17) 通过索引设置列表元素的值

LSET 命令的作用是通过索引来设置元素的值。

LSET 命令的语法格式如下：

LSET key_name index value

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

实例：

127.0.0.1:6379> RPUSH mylist "hello"
(integer) 1
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 2
127.0.0.1:6379> RPUSH mylist "foo"
(integer) 3
127.0.0.1:6379> RPUSH mylist "hello"
(integer) 4
127.0.0.1:6379> LSET mylist 0 "bar"
OK
127.0.0.1:6379> LRANGE mylist 0 -1
"bar"
"hello"
"foo"
"hello"