HASH
获取 HASH 值
读取指定 HASH 键对应的值到变量。
命令用途
Hash-Get 对应的实际命令写法是 HASH <标识> Get,用于读取指定 HASH 键对应的值到变量。
它常见于缓存读取、状态回显和后续条件分支前的值获取。
命令名
Hash-Get
调用格式
HASH <标识> Get <KEY> <变量>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要读取的 HASH 容器标识。 |
Get | 是 | 固定子命令,表示读取键值。 |
KEY | 是 | 要读取的键名。 |
变量 | 是 | 用于接收读取结果的变量。 |
返回或影响
- 该命令会把指定键对应的值写入目标变量。
- 它不是检查型命令,通常需要在读取后再继续判断或显示。
示例
基础用法
#ACT
HASH 活动状态 Get 报名开关 S10
SendMsg 5 "当前报名开关值:<$STR(S10)>"
这段写法适合先把 报名开关 读取到 S10,再继续显示或参与后续逻辑。
注意事项
- 这条命令只负责把值读到变量,不会直接告诉你键是否存在。
- 如果你更关心是否存在或是否过期,应结合
HashExists或Hash-GetE使用。 - 读取值也可以使用标签写法
<$HASH(标识)key>,效果等同Hash 标识 Get key S1。
