INI
读取 INI 字符串
从 INI 文件的指定节和键中读取字符串到 S/A 变量，适用于读取名称、说明、路径和文本配置项。
命令用途
Ini_Read_String 对应的实际命令写法是 INI_READ_STRING，用于从 INI 文件读取字符串值到 S 或 A 变量。
它通常用于读取配置名称、说明文字、标记文本、路径和需要继续拼接或显示的字符串结果。
命令名
Ini_Read_String
调用格式
INI_READ_STRING <文件路径> <节名> <键名> <变量>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
文件路径 | 是 | 目标 INI 文件路径。 |
节名 | 是 | 要读取的节名称。 |
键名 | 是 | 要读取的键名称。 |
变量 | 是 | 用于接收结果的字符串变量，应使用 S 或 A 变量。 |
返回或影响
- 该命令会把指定键的字符串值写入目标变量。
- 它不是检查型命令，通常配合
#ACT、#SAY、Mov、SendMsg等流程继续使用。 - 该命令只负责字符串读取；如果目标是整数值，应优先考虑
INI_READ_INTEGER。
示例
基础用法
#ACT
INI_READ_STRING .\Activity.ini Reward RewardName S10
这段写法会从 Activity.ini 的 Reward 节中读取 RewardName，并把结果写入 S10。
常见变体
#ACT
Ini_Read_String ..\QuestDiary\排行\排行.ini 排行 <$STR(S角色名)> S排行名
SendMsg 5 "当前读取到的排行名称：<$STR(S排行名)>"
这类写法用于按变量指定键名，从 INI 中读取文本配置后继续显示或拼接到其它流程里。
注意事项
- 当目标值是名称、路径、标记或说明文本时，优先用
INI_READ_STRING，不要读进整数变量。 - 如果 INI 内容刚被外部程序改过，而脚本里还是旧值，通常要先确认是否需要
INI_RELOAD。 Ini_Read_String是文档里的速查名，实际执行时使用的是大写命令INI_READ_STRING。