Redis ZRANGE 命令用于获取有序集合中指定范围内的元素。
语法
ZRANGE key start stop [WITHSCORES]
参数
- key:有序集合的key。
- start:起始下标,从0开始。
- stop:结束下标,-1表示一个元素。
- WITHSCORES:可选参数,表示是否获取元素的score值。
返回值
如果没有指定 WITHSCORES 选项,则返回指定范围内的元素列表;如果指定了 WITHSCORES 选项,则返回指定范围内的元素列表及元素的score值。
实例
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZRANGE myzset 0 -1 1) "one" 2) "two" 3) "three"
以上实例中,我们使用 ZRANGE 命令获取有序集合 myzset 中指定范围内的元素,起始下标为0,结束下标为-1,获取到的结果为:one,two,three。
实例2
redis> ZADD myzset 1 "one" (integer) 1 redis> ZADD myzset 2 "two" (integer) 1 redis> ZADD myzset 3 "three" (integer) 1 redis> ZRANGE myzset 0 -1 WITHSCORES 1) "one" 2) "1" 3) "two" 4) "2" 5) "three" 6) "3"
以上实例中,我们使用 ZRANGE 命令获取有序集合 myzset 中指定范围内的元素,起始下标为0,结束下标为-1,并指定 WITHSCORES 选项,获取到的结果为:one,1,two,2,three,3。