HASH
从文件加载 HASH
从文件加载指定 HASH 容器的数据。
命令用途
Hash-Load 对应的实际命令写法是 HASH <标识> Load,用于从文件加载指定 HASH 容器的数据。
它常见于开服初始化、缓存预热、共享配置装载和启动时恢复结构化键值数据。
命令名
Hash-Load
调用格式
HASH <标识> Load <文件名>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
标识 | 是 | 要接收加载结果的 HASH 容器标识。 |
Load | 是 | 固定子命令,表示从文件加载。 |
文件名 | 是 | 要加载的数据文件路径。 |
返回或影响
- 该命令会把指定文件中的数据加载到目标 HASH 容器。
- 常用于服务启动或功能初始化阶段,把外部文件内容导入内存 HASH。
示例
基础用法
#ACT
HASH 我的标识 Load ..\ItemData\ItemDesc.csv
这段写法适合在初始化时把物品描述数据文件加载到 我的标识。注意:H_ItemDesc 等 H_ 开头的标识为系统保留标识,请勿占用。
注意事项
- 目标文件不存在或内容格式不符合引擎要求时,加载结果通常不会符合预期。
- 如果后续还需要把运行期改动写回文件,通常要配合
Hash-Save或Hash-BGSave使用。 Hash-Load是速查名,实际执行时写法是HASH <标识> Load ...。
