*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
*常见错误
- 对非 Sorted Set 使用:返回 WRONGTYPE。
*最佳实践
- 排行榜规模监控:ZCARD 监控排行榜人数,防止无限增长。
- 滑动窗口清理:ZCARD > 阈值时,ZREMRANGEBYSCORE 清理旧数据。
*FAQ
Q: ZCARD 在大 Sorted Set 上慢吗? A: O(1),不遍历成员。维护计数器。