ZRANK

ZRANK key member [WITHSCORE]

Available since:

2.0.0

Time complexity:

O(log(N))

ACL categories:

@read, @sortedset, @fast,

Returns the rank of member in the sorted set stored at key, with the scores ordered from low to high. The rank (or index) is 0-based, which means that the member with the lowest score has rank 0.

The optional WITHSCORE argument supplements the command's reply with the score of the element returned.

Use ZREVRANK to get the rank of an element with the scores ordered from high to low.

Return

• If member exists in the sorted set:
  • using WITHSCORE, Array reply: an array containing the rank and score of member.
  • without using WITHSCORE, Integer reply: the rank of member.
• If member does not exist in the sorted set or key does not exist:
  • using WITHSCORE, Array reply: nil.
  • without using WITHSCORE, Bulk string reply: nil.

Note that in RESP3 null and nullarray are the same, but in RESP2 they are not.

Examples

redis> ZADD myzset 1 "one"
Failed to fetch
redis> ZADD myzset 2 "two"
Failed to fetch
redis> ZADD myzset 3 "three"
Failed to fetch
redis> ZRANK myzset "three"
Failed to fetch
redis> ZRANK myzset "four"
Failed to fetch
redis> ZRANK myzset "three" WITHSCORE
Failed to fetch
redis> ZRANK myzset "four" WITHSCORE
Failed to fetch

History

• Starting with Redis version 7.2.0: Added the optional WITHSCORE argument.