LRANGE 命令返回列表 key 中指定区间内的元素,区间以偏移量 start 和 stop 指定。
命令格式
LRANGE key start stop
可用版本:1.0.0
时间复杂度:O(S+N),S 为偏移量 start,N 为指定区间内元素的数量。
命令参数
- start:下标的起始位置,以0为底,0表示列表的第一个元素,1表示列表的第二个元素,以此类推,也可以是负数,以-1表示列表的最后一个元素,-2表示列表的倒数第二个元素,以此类推。
- stop:下标的结束位置,下标数字的意义与 start 相同。
stop 位置的元素是包含的,即元素的指定区间是闭区间,这和一些编程语言的范围值不包含结束位置不一样,需要注意。
下标参数超出范围
超出范围的下标值不会引起错误。
- 若 start 下标比列表的最大下标 end 还要大,那么 LRANGE 返回一个空列表。
- 若 stop 下标比列表的最大下标 end 还要大,那么将 stop 的值设置为 end。
命令返回值
LRANGE 命令返回一个在指定区间的列表。
示例
redis> RPUSH mylist one
(integer) 1
redis> RPUSH mylist two three
(integer) 3
redis> LRANGE mylist 0 0
1) "one"
redis> LRANGE mylist -3 2
1) "one"
2) "two"
3) "three"
redis> LRANGE mylist -100 100
1) "one"
2) "two"
3) "three"
redis> LRANGE mylist 5 10
(empty list or set)