INI
写入 INI 字符串
把字符串值写入指定 INI 文件的目标节和键。
命令用途
Ini_Write_String 对应的实际命令写法是 INI_WRITE_STRING，用于把字符串值写入指定 INI 文件的目标节和键。
它常见于名称记录、文本配置保存、日志拼装和需要把变量内容落到 INI 的场景。
命令名
Ini_Write_String
调用格式
INI_WRITE_STRING <文件路径> <节名> <键名> <变量/字符串>
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
文件路径 | 是 | 目标 INI 文件路径。 |
节名 | 是 | 要写入的节名称。 |
键名 | 是 | 要写入的键名称。 |
变量/字符串 | 是 | 要保存的字符串内容，可以直接写变量或固定文本。 |
返回或影响
- 该命令会把字符串值写入指定节和键。
- 这类修改不会自动落盘，通常还要配合
INI_SAVE。
示例
基础用法
#ACT
INI_WRITE_STRING .\Activity.ini Reward RewardName <$STR(S10)>
INI_SAVE .\Activity.ini
这段写法适合把变量 S10 中的奖励名称写入 Activity.ini。
常见变体
#ACT
INI_WRITE_STRING .\Activity.ini Reward RewardDesc 基础奖励配置
INI_SAVE .\Activity.ini
这类写法适合直接把固定文本写入目标键。
注意事项
- 如果目标值是整数统计或数值配置，优先使用
Ini_Write_Integer。 - 这条命令写入后通常还要显式执行
INI_SAVE，否则文件不会按预期更新。