Redis ZRANGE 命令

Redis ZRANGE 命令

Redis有序集合（sorted sets）

Redis ZRANGE 命令返回有序集中，指定区间内的成员，其中成员的按分数值递增(从小到大)来排序，具有相同分数值的成员按字典序(lexicographical order )来排列。

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

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

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

start 和 stop 都是包含在内的区间，因此例如 ZRANGE myzset 0 1 将会返回有序集合的第一个和第二个元素。

超出范围的索引不会产生错误。 如果 start 参数的值大于有序集合中的最大索引，或者 start > stop ，将会返回一个空列表。 如果 stop 的值大于有序集合的末尾，Redis 会将其视为有序集合的最后一个元素。

可以传递 WITHSCORES 选项，以便将元素的分数与元素一起返回。这样返回的列表将包含 value1,score1,...,valueN,scoreN ，而不是 value1,...,valueN 。 客户端类库可以自由地返回更合适的数据类型（建议：具有值和得分的数组或元组）。

语法

redis Zrange 命令基本语法如下：

redis 127.0.0.1:6379> ZRANGE key start stop [WITHSCORES]

可用版本

>= 1.2.0

返回值

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

示例

redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES             # 显示整个有序集成员
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"

redis 127.0.0.1:6379> ZRANGE salary 1 2 WITHSCORES              # 显示有序集下标区间 1 至 2 的成员
1) "tom"
2) "5000"
3) "boss"
4) "10086"

redis 127.0.0.1:6379> ZRANGE salary 0 200000 WITHSCORES         # 测试 end 下标超出最大下标时的情况
1) "jack"
2) "3500"
3) "tom"
4) "5000"
5) "boss"
6) "10086"

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

时间复杂度

ZRANGE 命令时间复杂度：O(log(N)+M) N是有序集合中元素的个数，M是返回的元素的个数。

Redis有序集合（sorted sets）