*Redis ZCARD 命令

返回 Sorted Set 的成员数量。


*语法

ZCARD key

*参数说明

参数 类型 必填 说明
key String Sorted Set 的键名

*返回值

条件 返回值
key 存在且为 Sorted Set 成员数量(Integer)
key 不存在 0
key 非 Sorted Set WRONGTYPE 错误

*时间复杂度

O(1)

*

*示例

> ZADD leaderboard 100 "p1" 200 "p2"
(integer) 2

> ZCARD leaderboard
(integer) 2

> ZCARD nonexistent
(integer) 0

*常见错误

  1. 对非 Sorted Set 使用:返回 WRONGTYPE。

*最佳实践

  1. 排行榜规模监控:ZCARD 监控排行榜人数,防止无限增长。
  2. 滑动窗口清理:ZCARD > 阈值时,ZREMRANGEBYSCORE 清理旧数据。

*FAQ

Q: ZCARD 在大 Sorted Set 上慢吗? A: O(1),不遍历成员。维护计数器。