ZREVRANGEBYSCORE

Returns members in a sorted set within a range of scores in reverse order.

Usage

ZREVRANGEBYSCORE key max min [WITHSCORES] [LIMIT offset count]

Description

Returns all the elements in the sorted set at key with a score between max and min (including elements with score equal to max or min). In contrary to the default ordering of sorted sets, for this command the elements are considered to be ordered from high to low scores.

The elements having the same score are returned in reverse lexicographical order.

Apart from the reversed ordering, ZREVRANGEBYSCORE is similar to ZRANGEBYSCORE.

Alternative

ZRANGE with the REV and BYSCORE arguments.

Reply

• Array reply: a list of the members and, optionally, their scores in the specified score range.

Complexity

O(log(N)+M) with N being the number of elements in the sorted set and M the number of elements being returned. If M is constant (e.g. always asking for the first 10 elements with LIMIT), you can consider it O(log(N)).

ACL Categories

@read @slow @sortedset

Examples

127.0.0.1:6379> ZADD myzset 1 "one"
(integer) 1
127.0.0.1:6379> ZADD myzset 2 "two"
(integer) 1
127.0.0.1:6379> ZADD myzset 3 "three"
(integer) 1
127.0.0.1:6379> ZREVRANGEBYSCORE myzset +inf -inf
1) "three"
2) "two"
3) "one"
127.0.0.1:6379> ZREVRANGEBYSCORE myzset 2 1
1) "two"
2) "one"
127.0.0.1:6379> ZREVRANGEBYSCORE myzset 2 (1
1) "two"
127.0.0.1:6379> ZREVRANGEBYSCORE myzset (2 (1
(empty array)

History

• 2.2.0: Introduced.
• 2.1.6: min and max can be exclusive.

See also

BZMPOP, BZPOPMAX, BZPOPMIN, ZADD, ZCARD, ZCOUNT, ZDIFF, ZDIFFSTORE, ZINCRBY, ZINTER, ZINTERCARD, ZINTERSTORE, ZLEXCOUNT, ZMPOP, ZMSCORE, ZPOPMAX, ZPOPMIN, ZRANDMEMBER, ZRANGE, ZRANGEBYLEX, ZRANGEBYSCORE, ZRANGESTORE, ZRANK, ZREM, ZREMRANGEBYLEX, ZREMRANGEBYRANK, ZREMRANGEBYSCORE, ZREVRANGE, ZREVRANGEBYLEX, ZREVRANK, ZSCAN, ZSCORE, ZUNION, ZUNIONSTORE.