【Redis】 Redis 列表指令指南
这是我父亲 日记里的文字
这是他的生命 留下留下来的散文诗
几十年后 我看着泪流不止
可我的父亲已经 老得像一个影子
🎵 许飞《父亲写的散文诗》
Redis 是一个开源的内存数据库，支持多种数据结构，其中列表（List）是一种常用的数据类型。Redis 列表是一个简单的链表，允许在头部和尾部进行快速的插入和删除操作，非常适合消息队列等应用场景。本文将详细介绍 Redis 列表的常用指令及其使用方法。
一、基本操作
- 左/右插入和弹出
LPUSH
LPUSH 命令用于将一个或多个值插入到列表头部。如果列表不存在，将创建一个空列表并执行插入操作。
LPUSH key value [value ...]
示例：
LPUSH mylist "world"
LPUSH mylist "hello"
# mylist 现在包含 ["hello", "world"]
RPUSH
RPUSH 命令用于将一个或多个值插入到列表尾部。如果列表不存在，将创建一个空列表并执行插入操作。
RPUSH key value [value ...]
示例：
RPUSH mylist "hello"
RPUSH mylist "world"
# mylist 现在包含 ["hello", "world"]
LPOP
LPOP 命令用于移除并返回列表头部的元素。
LPOP key
示例：
LPOP mylist
# 返回 "hello"
# mylist 现在包含 ["world"]
RPOP
RPOP 命令用于移除并返回列表尾部的元素。
RPOP key
示例：
RPOP mylist
# 返回 "world"
# mylist 现在包含 ["hello"]
二、获取列表元素
1. 获取指定范围内的元素
LRANGE
LRANGE 命令用于获取列表中指定范围内的元素。索引从0开始，可以使用负数表示从列表尾部开始的偏移量。
LRANGE key start stop
示例：
RPUSH mylist "one"
RPUSH mylist "two"
RPUSH mylist "three"
LRANGE mylist 0 1
# 返回 ["one", "two"]
LRANGE mylist 0 -1
# 返回 ["one", "two", "three"]
2. 获取列表长度
LLEN
LLEN 命令用于获取列表的长度。
LLEN key
示例：
LLEN mylist
# 返回 3
3. 获取指定索引的元素
LINDEX
LINDEX 命令用于通过索引获取列表中的元素。索引从0开始，可以使用负数表示从列表尾部开始的偏移量。
LINDEX key index
示例：
LINDEX mylist 1
# 返回 "two"
4. 设置指定索引的元素
LSET
LSET 命令用于设置列表中指定索引的元素。如果索引超出范围，将返回错误。
LSET key index value
示例：
LSET mylist 1 "new"
LINDEX mylist 1
# 返回 "new"
三、删除列表元素
1. 删除指定值的元素
LREM
LREM 命令用于从列表中删除指定值的元素。可以指定删除的数量，正数表示从头到尾删除，负数表示从尾到头删除，0 表示删除所有匹配的元素。
LREM key count value
示例：
RPUSH mylist "hello"
RPUSH mylist "hello"
RPUSH mylist "world"
LREM mylist -2 "hello"
# mylist 现在包含 ["world"]
2. 截取列表
LTRIM
LTRIM 命令用于对列表进行修剪，只保留指定范围内的元素。
LTRIM key start stop
示例：
RPUSH mylist "one"
RPUSH mylist "two"
RPUSH mylist "three"
LTRIM mylist 1 -1
# mylist 现在包含 ["two", "three"]
四、阻塞操作
1. 阻塞弹出元素
BLPOP
BLPOP 命令用于阻塞地移除并返回列表的第一个元素。如果列表为空，则阻塞等待直到有新的元素插入或超时。
BLPOP key [key ...] timeout
示例：
BLPOP mylist 5
# 如果 mylist 为空，阻塞最多 5 秒
BRPOP
BRPOP 命令用于阻塞地移除并返回列表的最后一个元素。如果列表为空，则阻塞等待直到有新的元素插入或超时。
BRPOP key [key ...] timeout
示例：
BRPOP mylist 5
# 如果 mylist 为空，阻塞最多 5 秒
五、插入和替换操作
1. 在指定元素前后插入新元素
LINSERT
LINSERT 命令用于在列表的指定值前或后插入新元素。如果指定值不存在，将不进行任何操作。
LINSERT key BEFORE|AFTER pivot value
示例：
RPUSH mylist "hello"
RPUSH mylist "world"
LINSERT mylist BEFORE "world" "there"
# mylist 现在包含 ["hello", "there", "world"]
结论
Redis 列表提供了丰富的指令，可以实现从简单的插入、删除到复杂的阻塞操作等多种功能。通过掌握这些指令，您可以充分利用 Redis 列表来处理各种应用场景，如消息队列、任务调度、日志存储等。希望这篇指南能帮助您更好地理解和使用 Redis 列表指令，如果有任何问题或需要进一步的帮助，欢迎随时提问。