兰吉
语法
LRANGE key start stop
- 从以下位置开始可用:
- 1.0.0
- 时间复杂度:
- O(S+N),其中 S 是小列表从 HEAD 开始偏移的距离,对于大型列表,从最近的终点(HEAD 或 TAIL)偏移的距离;N 是指定范围内的元素数。
- ACL 类别:
-
@read
,@list
,@slow
,
返回存储在key
.
偏移量start
和stop
是从 0 开始的索引,其中0
成为第一个
元素(列表的头部),1
成为下一个元素,因此
上。
这些偏移量也可以是负数,表示从
列表的末尾。
例如-1
是列表的最后一个元素,-2
倒数第二个,等等
上。
与各种编程语言中的 range 函数保持一致
请注意,如果您有一个从 0 到 100 的数字列表,LRANGE list 0 10
将
返回 11 个元素,即包含最右边的项。
这可能与范围相关函数的行为一致,也可能不一致
以您选择的编程语言(想想 Ruby 的Range.new
,Array#slice
或 Python 的range()
函数)。
超出范围的索引
超出范围的索引不会产生错误。
如果start
大于列表末尾,则返回空列表。
如果stop
大于列表的实际末尾,Redis 会将其视为
列表的最后一个元素。
例子
Give these commands a try in the interactive console:
RESP2/RESP3 Reply
Array reply: a list of elements in the specified range, or an empty array if the key doesn't exist.