ZRANK

返回按分数升序排序的有序集中成员的索引。

语法

ZRANK key member [WITHSCORE]

引入版本：2.0.0

复杂度摘要：O(log(N)

返回 member 在 key 存储的有序集合中的排名，分数从低到高排序。排名（或索引）从 0 开始，这意味着得分最低的成员的排名为 0。

可选的 WITHSCORE 参数用返回的元素的分数补充命令的回复。

使用ZREVRANK获取元素的排名，分数从高到低排序。

必需参数

key

保存有序集合的键的名称。

member

要返回等级的会员。

可选参数

WITHSCORE

同时返回会员的分数及其排名。

示例

redis> ZADD myzset 1 "one"
(integer) 1
redis> ZADD myzset 2 "two"
(integer) 1
redis> ZADD myzset 3 "three"
(integer) 1
redis> ZRANK myzset "three"
(integer) 2
redis> ZRANK myzset "four"
(nil)
redis> ZRANK myzset "three" WITHSCORE
1) (integer) 2
2) "3"
redis> ZRANK myzset "four" WITHSCORE
(nil)

Redis Software 与 Redis Cloud 兼容性

Redis 软件	Redis Cloud	说明
✅ 标准 ✅ 主动-主动	✅ 标准 ✅ 主动-主动

返回值

RESP2

以下之一： * 无回复：如果键不存在或成员不存在于有序集合中。 * 整数回复：未使用WITHSCORE时会员的等级。 * 数组回复：使用WITHSCORE时会员的排名和分数。

RESP3

以下之一： * 空回复：如果键不存在或成员不存在于有序集合中。 * 整数回复：未使用WITHSCORE时会员的等级。 * 数组回复：使用WITHSCORE时会员的排名和分数。

资料来源：Redis 官方 ZRANK 文档；中文内容参考 Redis 文档许可。