Redis 列表（Lists）命令详解

秒速五厘米 2021-10-19 20:16 430阅读 0赞

### 1. LPUSH key value1 \[value2\] ：首部插入 ###

将一个或多个值插入到列表头部  
返回值：执行 LPUSH 命令后，列表的长度。  
![在这里插入图片描述][20190815200415988.png]

### 2.LRANGE key start stop ：查询 ###

获取列表指定范围内的元素。  
返回值：一个列表，包含指定区间内的元素。  
![在这里插入图片描述][20190815201813825.png]

### 3. LINDEX key index ：根据索引查询 ###

通过索引获取列表中的元素。  
返回值：列表中下标为指定索引值的元素。 如果指定索引值不在列表的区间范围内，返回 nil 。  
![在这里插入图片描述][20190815201130227.png]

### 4. LINSERT key BEFORE|AFTER pivot value ：任意位置插入 ###

在列表的元素前或者后插入元素。  
返回值：如果命令执行成功，返回插入操作完成之后，列表的长度。 如果没有找到指定元素 ，返回 -1 。 如果 key 不存在或为空列表，返回 0 。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70]

### 5. LLEN key ：长度查询 ###

获取列表长度。  
返回值：列表的长度。  
![在这里插入图片描述][20190815200533394.png]

### 6. LPUSHX key value ：首部插入(列表已存在) ###

将一个值插入到已存在的列表头部  
返回值：LPUSHX 命令执行之后，列表的长度，列表不存在，返回0  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 1]

### 7. LSET key index value ：修改指定索引位置的值 ###

通过索引设置列表元素的值  
返回值：操作成功返回 ok ，否则返回错误信息。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 2]

### 8. LTRIM key start stop ：切片 ###

对一个列表进行修剪(trim)，就是说，让列表只保留指定区间内的元素，不在指定区间之内的元素都将被删除。  
![在这里插入图片描述][20190815203802443.png]

### 9. LPOP key ：首部删除（可获取删除的元素） ###

移出并获取列表的第一个元素。  
![在这里插入图片描述][20190815204141745.png]

### 10. LREM key count value ：删除指定数量的某个元素 ###

移除列表元素。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 3]

### 11. BLPOP key1 \[key2 \] timeout ：首部删除（阻塞） ###

移出并获取列表的第一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。  
![在这里插入图片描述][20190815210022461.png]

### 12. RPUSH key value1 \[value2\] ：追加（append操作） ###

在列表中添加一个或多个值；  
返回值：执行 RPUSH 操作后，列表的长度。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 4]

### 13. RPUSHX key value ：追加（原列表已存在） ###

为已存在的列表添加值；  
返回值：执行 Rpushx 操作后，列表的长度  
列表不存在，则返回0  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 5]

### 14. RPOP key ：尾部删除（可获取删除元素） ###

移除列表的最后一个元素，返回值为移除的元素。  
返回值：被移除的元素。  
当列表不存在时，返回 nil 。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 6]

### 15. BRPOP key1 \[key2 \] timeout ：尾部删除（阻塞） ###

移出并获取列表的最后一个元素， 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止。  
返回值：假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。 反之，返回一个含有两个元素的列表，第一个元素是被弹出元素所属的 key ，第二个元素是被弹出元素的值。  
![在这里插入图片描述][20190816095959353.png]

### 16. RPOPLPUSH source destination ：尾部删除，删除元素添加到另一个列表 ###

移除列表的最后一个元素，并将该元素添加到另一个列表并返回；  
返回值：被弹出的元素。  
![在这里插入图片描述][watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 7]

### 17. BRPOPLPUSH source destination timeout ：尾部删除，删除元素添加到另一个列表 （阻塞） ###

从列表中弹出一个值，将弹出的元素插入到另外一个列表中并返回它； 如果列表没有元素会阻塞列表直到等待超时或发现可弹出元素为止；  
返回值：假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。 反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长。  
![在这里插入图片描述][20190816100908235.png]

[20190815200415988.png]: /images/20211019/33e22b23e2304a35870f3c37f20a55a3.png
[20190815201813825.png]: /images/20211019/87b117c7dd0d41668a118880ccf689f8.png
[20190815201130227.png]: /images/20211019/db7aacc0592a4270817f968a70d532d1.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70]: /images/20211019/0370428a89b84cda90d405915f009ab2.png
[20190815200533394.png]: /images/20211019/afdb5cd74114408c8f4ca491b2da1d1b.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 1]: /images/20211019/6294b266b4214b16b1ba5f39a5670afe.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 2]: /images/20211019/9643aa8a44b14424b6ea52397c446608.png
[20190815203802443.png]: /images/20211019/a34ccbb08785465ea6dc59c7c55a5116.png
[20190815204141745.png]: /images/20211019/1b0cb74c57e640f5ba099f86ce6a9b1e.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 3]: /images/20211019/49e3fe976b4347f49df47e44f9d15ded.png
[20190815210022461.png]: /images/20211019/8e04d23dfd394142b288531642b3d2c8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 4]: /images/20211019/db66435d1e0a456d95c3d8e4a59473f8.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 5]: /images/20211019/60eab18c5c954630859962613d20c508.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 6]: /images/20211019/6035f52698584f8ab0825c3222d1060b.png
[20190816095959353.png]: /images/20211019/86e1bed6520946f2990b443a0f6b1215.png
[watermark_type_ZmFuZ3poZW5naGVpdGk_shadow_10_text_aHR0cHM6Ly9ibG9nLmNzZG4ubmV0L2d5bWFpc3ls_size_16_color_FFFFFF_t_70 7]: /images/20211019/9941ba70a343403e8c260a3f53168df0.png
[20190816100908235.png]: /images/20211019/5093467a47db4d3ca4edf18d73b5242f.png