ZRANK

用法
ZRANK key member [ WITHSCORE ]
复杂度
O(log(N))
起始版本
2.0.0
ACL 类别
@sortedset, @read, @fast

返回有序集合中 member 的排名(rank),其中分数从低到高排列。排名(或索引)是 0-based 的,这意味着分数最低的成员的排名是 0

可选的 WITHSCORE 参数会在命令的回复中补充返回元素的得分(score)。

使用 ZREVRANK 获取元素排名,其中分数从高到低排列。

示例

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> ZRANK myzset "three"
(integer) 2
127.0.0.1:6379> ZRANK myzset "four"
(nil)
127.0.0.1:6379> ZRANK myzset "three" WITHSCORE
1) (integer) 2
2) "3"
127.0.0.1:6379> ZRANK myzset "four" WITHSCORE
(nil)

RESP2 回复

以下之一

  • Nil 回复:如果键不存在或成员在有序集合中不存在。

  • 整数回复:当不使用 WITHSCORE 时成员的排名。

  • 数组回复:当使用 WITHSCORE 时成员的排名和得分。

RESP3 回复

以下之一

  • Null 回复:如果键不存在或成员在有序集合中不存在。

  • 整数回复:当不使用 WITHSCORE 时成员的排名。

  • 数组回复:当使用 WITHSCORE 时成员的排名和得分。

历史

版本 更改
7.2.0

添加了可选的 WITHSCORE 参数。