HASH
检查 HASH 键是否存在
在条件判断中检查指定 HASH 标识下是否存在某个键。
命令用途
HashExists 用于检查指定 HASH 标识下是否存在某个键。
它适合放在分支判断前，先确认某个键是否已经写入，再决定是否继续读取、覆盖或跳过后续流程。
命令名
HashExists
调用格式
HashExists <标识> <KEY>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要检查的 HASH 容器标识。 |
KEY | 是 | 要判断是否存在的键名。 |
返回或影响
- 这是检查型命令，只能在条件判断流程中使用。
- 当指定键存在时，
#IF判断通过。 - 它只判断键是否存在，不会把键值读到变量，也不会返回过期时间。
示例
基础用法
#IF
HashExists 活动状态 报名开关
#ACT
SendMsg 5 "报名开关已经写入。"
这段写法适合先判断 活动状态 里是否已经存在 报名开关，再决定是否继续处理。
常见变体
#IF
!HashExists <$USERNAME> 首充奖励
#ACT
HASH <$USERNAME> Set 首充奖励 1
这类写法用于先判断当前玩家是否还没有写入 首充奖励 标记，再补写初始值。
注意事项
HashExists只负责判断键是否存在，不会验证值内容是否符合预期。- 如果你后续还要读取实际值，应继续配合
Hash-Get。 - 如果你更关心键的剩余有效期，而不是单纯是否存在，应改用
Hash-GetE。