redis zrange 有序集合(sorted set)命令简介


一、命令简介

zrange 有序集合(sorted set) 命令在redis中主要功能是:

根据指定的索引 (从开始索引和结束位置)范围,返回索引范围内的元素列表


二、命令使用说明

命令语法如下:

 redis 192.168.8.123>zrange ssetKeyName startIndex endIndex
 或
 redis 192.168.8.123>zrange ssetKeyName startIndex endIndex withscores
 
注意事项:

   1 有序集合中的数据排列,按照排序字段的依次从小到大排列,如果遇见排序值一致的元素,则按照字典默认序进行排列。
   2  startIndex必须小于endIndex值
   3  listKeyName必须为list(列表)类型
   4  0表示 排序值 最小的元素的位置
   5  1表示 排序值 第二个小的元素的位置
   6  -1表示 排序值 最大的元素的位置 
   7  -2表示  排序值 倒数第二大的元素的位置
       ...依次类推
   8  当索引范围下无相关元素,则显示  < empty list or set > 
   9 startIndex endIndex 必须为整型
   10 命令后面加上 "withscores" ,客户端会返回排序值
   11 ssetKeyName 为空或元素值顺序错误或范围内无元素,则返回(empty list or set)
   12 ssetKeyName为非 "有序集合(sorted set)" 类型,系统则返回相应的错误提示信息


例:

 redis 192.168.8.123:6379> flushdb  //清空当前数据库
OK
redis 192.168.8.123:6379> zrange k 0 1 //对一个不存在的键,执行此命令,客户端返回empty信息
(empty list or set)
redis 192.168.8.123:6379> set k v
OK
redis 192.168.8.123:6379> zrange k 0 1 //对一个非 sorted set集合类型,客户端返回相应的错误信息
(error) WRONGTYPE Operation against a key holding the wrong kind of value
redis 192.168.8.123:6379> zadd k1 0 v1 2 v2 3 v3 4 v5 8 v7 0 v9
(integer) 6
redis 192.168.8.123:6379> zrange k1 0 -1 //获取一个  sorted set集合中的所有元素
1) "v1" 
2) "v9"
3) "v2"
4) "v3"
5) "v5"
6) "v7"
redis 192.168.8.123:6379> zrange k1 0 -1 withscores  //获取一个  sorted set集合中的所有元素 并将排序字段 同一打印出
 1) "v1"
 2) "0"
 3) "v9"
 4) "0"
 5) "v2"
 6) "2"
 7) "v3"
 8) "3"
 9) "v5"
10) "4"
11) "v7"
12) "8"
redis 192.168.8.123:6379> zrange k1 2 3 withscores //获取 第2个元素 ~ 第3个元素
1) "v2"
2) "2"
3) "v3"
4) "3"
redis 192.168.8.123:6379> zrange k1 200 300 withscores //获取一个不在区间中的元素
(empty list or set) 

如下图所示:

redis zrange sorted set命令用法简介

redis zrange sorted set命令用法简介


相关阅读:
redis zinterStore 有序集合(sorted set)命令简介
redis zincrby 有序集合(sorted set)命令简介
redis zcount 有序集合(sorted set)命令简介
redis zcard 有序集合(sorted set)命令简介
redis zadd 有序集合(sorted set)命令简介
redis 数据库 数据类型 “有序集合(sorted set)” 简介
redis 数据库 数据类型 “集合(set)” 简介
window redis 文件夹文件说明 (二) —[ redis-cli]
window redis 文件夹文件说明 (一 )
Redis 数据类型简介
windows下 Redis配置
c# redis应用实例
redis相关简介
KV数据库简介