Redis--常见数据类型List列表

目录

一、概念

二、命令

2.1 LPUSH

2.2 LPUSHX

2.3 RPUSH

2.4 RPUSHX

2.5 LRANGE

2.6 LPOP

2.7 RPOP

2.8 LINDEX

2.9 LINSERT

2.10 LLEN

2.11 阻塞版本命令

三、内部编码

---

一、概念

列表类型是用来存储多个有序的字符串，列表中的每个字符串称为元素（element），⼀个列表最多可以存储 个元素。在 Redis 中，可以对列表两端插入（push）和弹出（pop），还可以获取指定范围的元素列表、获取指定索引下标的元素等。列表是⼀种比较灵活的数据结构，它可以充当栈和队列的角色，在实际开发上有很多应用场景。

列表类型的特点：

   

第⼀、列表中的元素是有序的，这意味着可以通过索引下标获取某个元素或者某个范围的元素列表。

第⼆、区分获取和删除的区别。

第三、列表中的元素是允许重复的。

二、命令

2.1 LPUSH

将⼀个或者多个元素从左侧放入（头插）到 list 中。

语法：

LPUSH key element [element ...]

命令有效版本：1.0.0 之后

时间复杂度：只插入⼀个元素为 O(1), 插入多个元素为 O(N), N 为插入元素个数.

返回值：插⼊后 list 的长度。

示例：

redis> LPUSH mylist "world"
(integer) 1
redis> LPUSH mylist "hello"
(integer) 2
redis> LRANGE mylist 0 -1
1) "hello"
2) "world"

2.2 LPUSHX

在 key 存在时，将⼀个或者多个元素从左侧放入（头插）到 list 中。不存在，直接返回。

语法：

LPUSHX key element [element ...]

命令有效版本：2.0.0 之后

时间复杂度：只插入⼀个元素为 O(1), 插入多个元素为 O(N), N 为插入元素个数.

返回值：插入后 list 的长度。

示例：

(integer) 1
redis> LPUSHX mylist "Hello"
(integer) 2
redis> LPUSHX myotherlist "Hello"
(integer) 0
redis> LRANGE mylist 0 -1
1) "Hello"
2) "World"
redis> LRANGE myotherlist 0 -1
(empty array)

2.3 RPUSH

将⼀个或者多个元素从右侧放入（尾插）到 list 中。

语法：

RPUSH key element [element ...]

命令有效版本：1.0.0 之后

时间复杂度：只插入⼀个元素为 O(1), 插入多个元素为 O(N), N 为插入元素个数.

返回值：插入后 list 的长度。

示例：

redis> RPUSH mylist "world"
(integer) 1
redis> RPUSH mylist "hello"
(integer) 2
redis> LRANGE mylist 0 -1
1) "world"
2) "hello"

2.4 RPUSHX

在 key 存在时，将⼀个或者多个元素从右侧放入（尾插）到 list 中。

语法：

RPUSHX key element [element ...]

命令有效版本：2.0.0 之后

时间复杂度：只插入⼀个元素为 O(1), 插入多个元素为 O(N), N 为插入元素个数.

返回值：插入后 list 的长度。

示例：

redis> RPUSH mylist "World"
(integer) 1
redis> RPUSHX mylist "Hello"
(integer) 2
redis> RPUSHX myotherlist "Hello"
(integer) 0
redis> LRANGE mylist 0 -1
1) "World"
2) "Hello"
redis> LRANGE myotherlist 0 -1
(empty array)

2.5 LRANGE

获取从 start 到 end 区间的所有元素，左闭右闭。

语法：

LRANGE key start stop

命令有效版本：1.0.0 之后

时间复杂度：O(N)

返回值：指定区间的元素。

示例：

redis> RPUSH mylist "one"
(integer) 1
redis> RPUSH mylist "two"
(integer) 2
redis> RPUSH mylist "three"
(integer) 3
redis> LRANGE mylist 0 0
1) "one"
redis> LRANGE mylist -3 2
1) "one"
2) "two"
3) "three"
redis> LRANGE mylist -100 100
1) "one"
2) "two"
3) "three"
redis> LRANGE mylist 5 10
(empty array)

2.6 LPOP

从 list 左侧取出元素（即头删）。

语法：

LPOP key

命令有效版本：1.0.0 之后

时间复杂度：O(1)

返回值：取出的元素或者 nil。

示例：

redis> RPUSH mylist "one" "two" "three" "four" "five"
(integer) 5
redis> LPOP mylist
"one"
redis> LPOP mylist
"two"
redis> LPOP mylist
"three"
redis> LRANGE mylist 0 -1
1) "four"
2) "five"

2.7 RPOP

从 list 右侧取出元素（即尾删）。

语法：

RPOP key

命令有效版本：1.0.0 之后

时间复杂度：O(1)

返回值：取出的元素或者 nil。

示例;

redis> RPUSH mylist "one" "two" "three" "four" "five"
(integer) 5
redis> RPOP mylist
"five"
redis> LRANGE mylist 0 -1
1) "one"
2) "two"
3) "three"
4) "four"

2.8 LINDEX

获取从左数第 index 位置的元素。

语法：

LINDEX key index

命令有效版本：1.0.0 之后

时间复杂度：O(N)

返回值：取出的元素或者 nil。

示例：

redis> LPUSH mylist "World"
(integer) 1
redis> LPUSH mylist "Hello"
(integer) 2
redis> LINDEX mylist 0
"Hello"
redis> LINDEX mylist -1
"World"
redis> LINDEX mylist 3
(nil)

2.9 LINSERT

在特定位置插入元素。

语法：

LINSERT key <BEFORE | AFTER> pivot element

命令有效版本：2.2.0 之后

时间复杂度：O(N)

返回值：插⼊后的 list 长度。

示例：

redis> RPUSH mylist "Hello"
(integer) 1
redis> RPUSH mylist "World"
(integer) 2
redis> LINSERT mylist BEFORE "World" "There"
(integer) 3
redis> LRANGE mylist 0 -1
1) "Hello"
2) "There"
3) "World"

2.10 LLEN

获取 list 长度。

语法：

 LLEN key

命令有效版本：1.0.0 之后

时间复杂度：O(1)

返回值：list 的长度。

示例：

redis> LPUSH mylist "World"
(integer) 1
redis> LPUSH mylist "Hello"
(integer) 2
redis> LLEN mylist
(integer) 2

2.11 阻塞版本命令

blpop 和 brpop 是 lpop 和 rpop 的阻塞版本，和对应非阻塞版本的作用基本⼀致，除了：

在列表中有元素的情况下，阻塞和非阻塞表现是⼀致的。但如果列表中没有元素，非阻塞版本会理

解返回 nil，但阻塞版本会根据 timeout，阻塞⼀段时间，期间 Redis 可以执行其他命令，但要求执

行该命令的客户端会表现为阻塞状态。

命令中如果设置了多个键，那么会从左向右进行遍历键，⼀旦有⼀个键对应的列表中可以弹出元

素，命令立即返回。

如果多个客户端同时多⼀个键执行 pop，则最先执行命令的客户端会得到弹出的元素。

三、内部编码

列表类型的内部编码有两种：

ziplist（压缩列表）：当列表的元素个数小于 list-max-ziplist-entries 配置（默认 512 个），同时

列表中每个元素的长度都小于 list-max-ziplist-value 配置（默认 64 字节）时，Redis 会选用

ziplist 来作为列表的内部编码实现来减少内存消耗。

linkedlist（链表）：当列表类型无法满足 ziplist 的条件时，Redis 会使用 linkedlist 作为列表的内

部实现。