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 ...。

相关命令