Redis 列表（List）

Redis 列表是最简单的字符串列表，按照插入的顺序，我们可以添加一个元素到列表的头部或者尾部。一个列表最多可以包含 4294968295（2^32 - 1）个元素。常用的命令如下所示：Redis List 常用命令命令说明返回值示例LPUSH key value1 [value2 ...]将一个或多个值插入到列表头部。如果 key 值不存在，会先创建再执行 LPUSH 命令，如果 key 值存在

文丑颜不良啊

10838人浏览 · 2021-09-27 18:51:49

文丑颜不良啊 · 2021-09-27 18:51:49 发布

Redis 列表是最简单的字符串列表，按照插入的顺序，我们可以添加一个元素到列表的头部或者尾部。一个列表最多可以包含 4294968295（2^32 - 1）个元素。

常用的命令如下所示：

Redis List 常用命令
命令	说明	返回值	示例
LPUSH key value1 [value2 ...]	将一个或多个值插入到列表头部。如果 key 值不存在，会先创建再执行 LPUSH 命令，如果 key 值存在但不是列表类型时，返回一个错误	返回执行命令之后列表的长度
RPUSH key value1 [value2 ...]	将一个或多个值插入到列表尾部。如果 key 值不存在，会先创建再执行 LPUSH 命令，如果 key 值存在但不是列表类型时，返回一个错误	返回执行命令之后列表的长度
LPUSH key value	将一个值插入到已存在的列表的头部，列表不存在时操作无效	返回执行命令之后列表的长度
RPUSH key value	将一个值插入到已存在的列表的尾部，列表不存在时操作无效	返回执行命令之后列表的长度
LLEN key	返回列表长度，如果 key 不存在，返回 0，如果 key 不是列表列表类型，返回错误	返回列表长度
LINDEX key index	用于通过索引获取列表中的元素，0 表示第一个元素，-1 表示最后一个元素，-2 表示倒数第二个元素	返回列表中指定索引值的元素，如果指定索引值不在列表的区间范围内，返回 nil
LSET key index value	通过索引来设置元素的值，当指定索引超出范围，或者列表不存在时，返回错误	成功返回 OK，失败返回错误
LPOP key	用于移除并返回列表的第一个元素	返回列表的第一个元素，当 key 不存在时，返回 nil
RPOP key	用于移除并返回列表的最后一个元素	返回列表的最后一个元素，当 key 不存在时，返回 nil
LINSERT key BEFORE\|AFTER pivot value	用于在指定的元素之前或之后插入指定的元素，value为待插入的元素，pivot 为列表中的元素，当 pivot 不存在时，或列表不存在时，不执行任何操作，当 key 不是列表时，返回错误	执行成功返回插入之后列表的长度；如果指定的 pivot 不存在，返回 -1；如果 key 不存在，返回 0
LRANGE key start stop	获取列表中指定区间的元素，0 表示列表中第一个元素，-1 表示列表中最后一个元素	返回一个包含指定区间内元素的列表
LTRIM key start stop	对列表进行修剪，只保留指定区间内的元素，不在区间内的元素都删除，0 表示列表中第一个元素，-1 表示列表中最后一个元素	执行成功返回 OK
RPOPLPUSH source distination	将 source 列表中最后一个元素移除，并将该元素添加到 destination 列表中，可简单理解为“尾删头插”	返回被移除的元素
BRPOPLPUSH source destination timeout	从列表中取出最后一个元素并插入到另一个元素的头部（尾删头插），如果列表没有元素会阻塞知直到超时会发现可弹出元素为止，timeout 的单位为秒	假如在指定时间内没有任何元素被弹出，则返回一个 nil 和等待时长。反之，返回一个含有两个元素的列表，第一个元素是被弹出元素的值，第二个元素是等待时长	官方文档表名有元素弹出时会返回等待时长，实际测试发现并没有等待时长返回
BLPOP key1 [key2] timeout	移除列表中的第一个元素，如果列表没有元素会阻塞直到超时或者发现可弹出元素为止，timeout 的单位为秒	返回一个含有两个元素的列表，如果元素存在，第一个元素是被弹出元素的 key，第二个元素是被弹出的元素；如果列表为空，第一个元素是 nil，第二个元素是等待时长
BRPOP key1 [key2] timeout	移除列表中的最后一个元素，如果列表没有元素会阻塞直到超时或者发现可弹出元素为止，timeout 的单位为秒	返回一个含有两个元素的列表，如果元素存在，第一个元素是被弹出元素的 key，第二个元素是被弹出的元素；如果列表为空，第一个元素是 nil，第二个元素是等待时长
LREM key count value	移除列表中与指定元素相等的元素，count > 0：从头到尾搜索，移除与 value 相等的元素，数量为 count；count < 0：从尾到头搜索，移除与 value 相等的元素，数量为 count 的绝对值；count = 0：移除列表中所有与 value 相等的元素	返回被删除元素的数量，列表不存在时也返回0