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。

相关命令