directory search
Cluster cluster addslots(集群 槽位) cluster count failure reports(集群计数失败报告) cluster countkeysinslot cluster delslots cluster failover cluster forget cluster getkeysinslot cluster info cluster keyslot(集群键槽) cluster meet cluster nodes(集群节点) cluster replicate(集群复制) cluster reset(集群重置) cluster saveconfig cluster set config epoch cluster setslot cluster slaves cluster slots readonly readwrite Connection auth echo ping quit select swapdb Geo geoadd geodist geohash geopos georadius georadiusbymember Hashes hdel hexists hget hgetall hincrby hincrbyfloat hkeys hlen hmget hmset hscan hset hsetnx hstrlen hvals HyperLogLog pfadd pfcount pfmerge Keys del dump exists expire expireat keys migrate move object persist pexpire pexpireat pttl randomkey rename renamenx restore scan sort touch ttl type unlink wait Lists blpop brpop brpoplpush lindex linsert llen lpop lpush lpushx lrange lrem lset ltrim rpop rpoplpush rpush rpushx Pub/Sub psubscribe publish pubsub punsubscribe subscribe unsubscribe Scripting eval evalsha script debug script exists script flush script kill script load Server bgrewriteaof bgsave client getname client kill client list client pause client reply client setname command command count command getkeys command info config get config resetstat config rewrite config set dbsize debug object debug segfault flushall flushdb info lastsave monitor role save shutdown slaveof slowlog time Sets sadd scard sdiff sdiffstore sinter sinterstore sismember smembers smove spop srandmember srem sscan sunion sunionstore Sorted Sets zadd zcard zcount zincrby zinterstore zlexcount zrange zrangebylex zrangebyscore zrank zrem zremrangebylex zremrangebyrank zremrangebyscore zrevrange zrevrangebylex zrevrangebyscore zrevrank zscan zscore zunionstore Strings append bitcount bitfield bitop bitpos decr decrby get getbit getrange getset incr incrby incrbyfloat mget mset msetnx psetex set setbit setex setnx setrange strlen Transactions discard exec multi unwatch watch
characters

ZRANGE key start stop [WITHSCORES]

自1.2.0起可用。

时间复杂度: O( log(N)+ M),其中 N 是有序集合中元素的数量,M 是返回元素的数量。

返回存储在的有序集合中指定范围的元素key。这些元素被认为是从最低分到最高分排序。字典顺序用于得分相同的元素。

当需要从最高到最低分数排序的元素时(请参阅相同分数元素的降序排列顺序),请参阅 ZREVRANGE。

两个startstop是基于零的索引,其中0是第一要素,1是下一个元素等。它们也可以是负数,表示排序集结尾的偏移量,是排序集-1的最后一个元素,-2倒数第二个元素等等。

startstop包含范围,所以例如ZRANGE myzset 0 1将返回排序集合的第一个元素和第二个元素。

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

可以传递WITHSCORES选项以将元素的分数与元素一起返回。返回的列表将包含value1,score1,...,valueN,scoreN而不是value1,...,valueN。客户端库可以自由返回更合适的数据类型(建议:具有(值,分数)数组/元组的数组)。

返回值

数组回复:指定范围内的元素列表(可选择其分数,以防WITHSCORES给出选项)。

例子

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" 

redis>  ZRANGE myzset 2 3 1) "three" 

redis>  ZRANGE myzset -2 -1 1) "two" 2) "three"

以下示例WITHSCORES显示了该命令如何总是返回一个数组,但这次使用 element_1 score_1 element_2 score_2 ,... ,element_N score_N 填充

redis>  ZRANGE myzset 0 1 WITHSCORES 1) "one" 2) "1" 3) "two" 4) "2"

Previous article: Next article: