*Redis HLEN 命令 获取哈希表中字段的数量

*语法

HLEN key

*中文详细说明

返回哈希表（Hash）中字段（field）的数量。

  • 如果 key 不存在，返回 0。
  • 仅返回字段的数量，不返回字段的值。
  • 这是一个非常高效的操作，Redis 内部会维护字段计数，无需遍历所有字段。

*示例

# 示例 1: 获取字段数量
redis-cli HSET myhash field1 "Hello" field2 "World"
redis-cli HLEN myhash
# 返回: (integer) 2

# 示例 2: key 不存在
redis-cli HLEN nonexistent_key
# 返回: (integer) 0

# 示例 3: 删除字段后数量变化
redis-cli HSET myhash field1 "a" field2 "b" field3 "c"
redis-cli HLEN myhash
# 返回: (integer) 3
redis-cli HDEL myhash field1
redis-cli HLEN myhash
# 返回: (integer) 2

*返回值

类型 说明
Integer 哈希表中字段的数量；key 不存在时返回 0

*版本兼容性

版本 说明
>= 2.0.0 可用

*时间复杂度

  • O(1) — Redis 内部直接维护字段计数，无需遍历。