Redis Zrange 命令


Redis Zrange 返回有序集中,指定区间内的成员。

其中成员的位置按分数值递增(从小到大)来排序。

具有相同分数值的成员按字典序(lexicographical order )来排列。

如果你需要成员按

值递减(从大到小)来排列,请使用 ZREVRANGE 命令。

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

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

语法

redis Zrange 命令基本语法如下:

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

可用版本

>= 1.2.0

返回值

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

实例

  1. redis 127.0.0.1:6379> ZRANGE salary 0 -1 WITHSCORES # 显示整个有序集成员
  2. 1) "jack"
  3. 2) "3500"
  4. 3) "tom"
  5. 4) "5000"
  6. 5) "boss"
  7. 6) "10086"
  8.  
  9. redis 127.0.0.1:6379> ZRANGE salary 1 2 WITHSCORES # 显示有序集下标区间 1 至 2 的成员
  10. 1) "tom"
  11. 2) "5000"
  12. 3) "boss"
  13. 4) "10086"
  14.  
  15. redis 127.0.0.1:6379> ZRANGE salary 0 200000 WITHSCORES # 测试 end 下标超出最大下标时的情况
  16. 1) "jack"
  17. 2) "3500"
  18. 3) "tom"
  19. 4) "5000"
  20. 5) "boss"
  21. 6) "10086"
  22.  
  23. redis > ZRANGE salary 200000 3000000 WITHSCORES # 测试当给定区间不存在于有序集时的情况
  24. (empty list or set)