Redis之List类型解读

你的名字 2023-10-14 23:11 121阅读 0赞

**目录**

List简介

数据结构

常见命令

概述

LPUSH key value1 \[value2\]

LPUSHX key value

LINDEX key index

LLEN key

LPOP key

LRANGE key start stop

--------------------

#### **List简介** ####

列表list是一个单键多值的

Redis 列表是简单的字符串列表，按照插入顺序排序。你可以添加一个元素到列表的头部（左边）或者尾部（右边）。它的底层实际是个双向链表，对两端的操作性能很高，通过索引下标的操作中间的节点性能会较差。

![8924d6b19dea4333aab87442f7eaca31.png][]

#### 数据结构 ####

List的数据结构为快速链表 quickList。  
在列表元素较少的情况下使用一块连续的内存存储，这个结构式ziplist ，也即是压缩列表。他将所有的元素紧挨着一起存储，分配的是一块连续的内存。  
当数量比较多的时候才会改为quicklist。因为普通的链表需要的附加指针空间太大，会比较浪费空间，比如这个列表里存的只是int类型的数据，结构上还需要两个额外的指针prev和next。

> 在引入quicklist之前，Redis采用压缩链表（ziplist）以及双向链表（adlist）作为List的底层实现。当元素个数比较少并且元素长度比较小时，Redis采用ziplist作为其底层存储；当任意一个条件不满足时，Redis采用adlist作为底层存储结构。

**quicklist每个节点的实际数据存储结构为ziplist，**这种结构的主要优势在于节省存储空间。

![b8a1993bf1b14db3951b1b8ac9f85aff.png][]

![5ebe6a2417c5460cb927cd1e14bccd5d.png][]

#### 常见命令 ####

##### 概述 #####

<table> 
 <tbody> 
  <tr> 
   <th>序号</th> 
   <th>命令及描述</th> 
  </tr> 
  <tr> 
   <td>1</td> 
   <td><a href="https://www.redis.net.cn/order/3577.html" title="BLPOP key1 [key2 ] timeout" rel="nofollow">BLPOP key1 [key2 ] timeout</a>&nbsp;移出并获取列表的第一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。</td> 
  </tr> 
  <tr> 
   <td>2</td> 
   <td><a href="https://www.redis.net.cn/order/3578.html" title="BRPOP key1 [key2 ] timeout" rel="nofollow">BRPOP key1 [key2 ] timeout</a>&nbsp;移出并获取列表的最后一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。</td> 
  </tr> 
  <tr> 
   <td>3</td> 
   <td><a href="https://www.redis.net.cn/order/3579.html" title="BRPOPLPUSH source destination timeout" rel="nofollow">BRPOPLPUSH source destination timeout</a>&nbsp;从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它； 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。</td> 
  </tr> 
  <tr> 
   <td>4</td> 
   <td><a href="https://www.redis.net.cn/order/3580.html" title="LINDEX key index" rel="nofollow">LINDEX key index</a>&nbsp;通过索引获取列表中的元素</td> 
  </tr> 
  <tr> 
   <td>5</td> 
   <td><a href="https://www.redis.net.cn/order/3581.html" title="LINSERT key BEFORE|AFTER pivot value" rel="nofollow">LINSERT key BEFORE|AFTER pivot value</a>&nbsp;在列表的元素前或者后插入元素</td> 
  </tr> 
  <tr> 
   <td>6</td> 
   <td><a href="https://www.redis.net.cn/order/3582.html" title="LLEN key" rel="nofollow">LLEN key</a>&nbsp;获取列表长度</td> 
  </tr> 
  <tr> 
   <td>7</td> 
   <td><a href="https://www.redis.net.cn/order/3583.html" title="LPOP key" rel="nofollow">LPOP key</a>&nbsp;移出并获取列表的第一个元素</td> 
  </tr> 
  <tr> 
   <td>8</td> 
   <td><a href="https://www.redis.net.cn/order/3584.html" title="LPUSH key value1 [value2]" rel="nofollow">LPUSH key value1 [value2]</a>&nbsp;将一个或多个值插入到列表头部</td> 
  </tr> 
  <tr> 
   <td>9</td> 
   <td><a href="https://www.redis.net.cn/order/3585.html" title="LPUSHX key value" rel="nofollow">LPUSHX key value</a>&nbsp;将一个或多个值插入到已存在的列表头部</td> 
  </tr> 
  <tr> 
   <td>10</td> 
   <td><a href="https://www.redis.net.cn/order/3586.html" title="LRANGE key start stop" rel="nofollow">LRANGE key start stop</a>&nbsp;获取列表指定范围内的元素</td> 
  </tr> 
  <tr> 
   <td>11</td> 
   <td><a href="https://www.redis.net.cn/order/3587.html" title="LREM key count value" rel="nofollow">LREM key count value</a>&nbsp;移除列表元素</td> 
  </tr> 
  <tr> 
   <td>12</td> 
   <td><a href="https://www.redis.net.cn/order/3588.html" title="LSET key index value" rel="nofollow">LSET key index value</a>&nbsp;通过索引设置列表元素的值</td> 
  </tr> 
  <tr> 
   <td>13</td> 
   <td><a href="https://www.redis.net.cn/order/3589.html" title="LTRIM key start stop" rel="nofollow">LTRIM key start stop</a>&nbsp;对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。</td> 
  </tr> 
  <tr> 
   <td>14</td> 
   <td><a href="https://www.redis.net.cn/order/3590.html" title="RPOP key" rel="nofollow">RPOP key</a>&nbsp;移除并获取列表最后一个元素</td> 
  </tr> 
  <tr> 
   <td>15</td> 
   <td><a href="https://www.redis.net.cn/order/3591.html" title="RPOPLPUSH source destination" rel="nofollow">RPOPLPUSH source destination</a>&nbsp;移除列表的最后一个元素，并将该元素添加到另一个列表并返回</td> 
  </tr> 
  <tr> 
   <td>16</td> 
   <td><a href="https://www.redis.net.cn/order/3592.html" title="RPUSH key value1 [value2]" rel="nofollow">RPUSH key value1 [value2]</a>&nbsp;在列表中添加一个或多个值</td> 
  </tr> 
  <tr> 
   <td>17</td> 
   <td><a href="https://www.redis.net.cn/order/3593.html" title="RPUSHX key value" rel="nofollow">RPUSHX key value</a>&nbsp;为已存在的列表添加值</td> 
  </tr> 
 </tbody> 
</table>

##### LPUSH key value1 \[value2\] #####

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

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

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

##### LPUSHX key value #####

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

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

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

##### LINDEX key index #####

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

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

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

##### LLEN key #####

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

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

> 返回值：列表的长度

##### LPOP key #####

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

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

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

##### LRANGE key start stop #####

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

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

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

[8924d6b19dea4333aab87442f7eaca31.png]: https://img-blog.csdnimg.cn/8924d6b19dea4333aab87442f7eaca31.png
[b8a1993bf1b14db3951b1b8ac9f85aff.png]: https://img-blog.csdnimg.cn/b8a1993bf1b14db3951b1b8ac9f85aff.png
[5ebe6a2417c5460cb927cd1e14bccd5d.png]: https://img-blog.csdnimg.cn/5ebe6a2417c5460cb927cd1e14bccd5d.png