ZREVRANGEBYSCORE(3valkey)

📦
version 9.0.6 · 2 versions
, in fedora 44

ZREVRANGEBYSCORE 💅

okay bestie, this is the Valkey Command Manual page for ZREVRANGEBYSCORE — aka the sorted-set glow-up that hands you your members from biggest score to smallest. no cap. 🦋

✨ NAME ✨

zrevrangebyscore — returns members in a sorted set within a range of scores in reverse order. yes, backwards, on purpose, iconic behavior 💖

🎀 SYNOPSIS 🎀

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

note that it's max first and min second, bestie. that trips everybody up the first time. max min. do not come for me. 🙈

🌸 DESCRIPTION 🌸

So here's the tea ☕ — it returns all the elements in the sorted set at key with a score between max and min, and yes that range is inclusive: elements whose score is exactly equal to max or exactly equal to min are coming to the party too. 🎉

And here's the plot twist: unlike the default ordering of sorted sets, for this command the elements are considered to be ordered from high scores down to low scores. highest first, periodt. 👑

When multiple elements are out here with the same score, they get returned in reverse lexicographical order. like, alphabetically, but make it backwards. 🌀

Other than the whole reversed-ordering thing, ZREVRANGEBYSCORE is basically ZRANGEBYSCORE's mirror twin. same energy, flipped. 🪞

🧚 Alternative

ZRANGE with the REV and BYSCORE arguments. that's it, that's the alternative. iykyk ✨

💖 REPLY 💖

  • valkey-protocol(7) Array reply: a list of the members and, optionally, their scores in the specified score range. you get the scores only if you asked for them with WITHSCORES, obviously bestie. 🫶

⭐ COMPLEXITY ⭐

O(log(N)+M) — where N is the number of elements in the sorted set and M is the number of elements being returned. math is giving main character energy today. 🔥

and here's a lil cheat code: if M is constant (like, say, you're always asking for the first 10 elements with LIMIT), you can consider it O(log(N)). slay. 💅

🎀 ACL CATEGORIES 🎀

  • @read
  • @slow
  • @sortedset

three lil badges of honor. 🌈

🦋 HISTORY 🦋

  • Available since: 2.2.0 — a true elder, respectfully.
  • Changed in 2.1.6: min and max can be exclusive. — yeah, the exclusive thing was added there. note that the "available since" version is numerically higher than the "changed in" version. i don't make the rules, i just report them. 💀

🌈 EXAMPLES 🌈

watch her work:

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)

see that? +inf to -inf pulls everything back-to-front — "three", "two", "one". and the parentheses? that's the exclusive flex. (1 means "not 1", so 1 dips out. (2 and (1 together means nothing qualifies, and you get the empty array. a tragedy, honestly. 😭

💜 SEE ALSO 💜

the whole friend group, fr fr. 🫂

ok that's the whole page bestie, every flag, every number, every warning, nothing skipped. go forth and query in reverse. 🧚‍♀️

this was Valkey 9.0.0, dated 2025-10-21 — and that's the ZREVRANGEBYSCORE(3valkey) page, wrapped with love. mwah. 💋

📦 where this page comes from