Redis ZRANGE 命令 - Redis 基础教程 - 简单教程，简单编程

Redis ZRANGE 返回有序集中指定区间内的成员

( Redis >= 1.2.0 )

下标参数 start 和 stop 都以 0 为开始，也就是说，以 0 表示有序集第一个成员，以 1 表示有序集第二个成员...。

也可以使用负数下标，以 -1 表示最后一个成员， -2 表示倒数第二个成员...。

语法

Redis ZRANGE 命令语法如下：

127.0.0.1:6379> ZRANGE key start stop [WITHSCORES]

返回值

指定区间内，带有分数值(可选)的有序集成员的列表。

成员的位置按分数值递增(从小到大)来排序。
具有相同分数值的成员按字典序(lexicographical order )来排列

如果你需要成员按值递减(从大到小)来排列，请使用 ZREVRANGE 命令

范例

127.0.0.1:6379> FLUSHALL
OK
127.0.0.1:6379> ZADD chars 1 a 2 b 2 c 3 d 3 e 4 f 4 g 5 h 5 i
(integer) 9

127.0.0.1:6379> ZRANGE chars 0 -1 WITHSCORES    # 显示整个有序集成员
 1) "a"
 2) "1"
 3) "b"
 4) "2"
 5) "c"
 6) "2"
 7) "d"
 8) "3"
 9) "e"
10) "3"
11) "f"
12) "4"
13) "g"
14) "4"
15) "h"
16) "5"
17) "i"
18) "5"

127.0.0.1:6379> ZRANGE chars 1 2 WITHSCORES   # 显示有序集下标区间 1 至 2 的成员
1) "b"
2) "2"
3) "c"
4) "2"

127.0.0.1:6379> ZRANGE chars 0 10 WITHSCORES # 测试 end 下标超出最大下标时的情况
 1) "a"
 2) "1"
 3) "b"
 4) "2"
 5) "c"
 6) "2"
 7) "d"
 8) "3"
 9) "e"
10) "3"
11) "f"
12) "4"
13) "g"
14) "4"
15) "h"
16) "5"
17) "i"
18) "5"

redis > ZRANGE chars 10 20 WITHSCORES   # 测试当给定区间不存在于有序集时的情况
(empty list or set)