文本与文件
覆盖写入指定行
将文字或变量内容覆盖写入指定文本文件的某一行，可选实时落盘，适用于排行刷新、指定槽位重写和文本结果回填。
命令用途
WriteLine 用于把文字或变量内容覆盖写入指定文件的某一行。
它适合处理按行组织的数据，例如刷新排行榜某个名次、重写某个槽位的文本结果，或把中间计算结果回填到指定行号。
命令名
WriteLine
调用格式
WriteLine <文件路径> <行数> <写入内容> [HardDisk]
参数说明
| 参数 | 必填 | 说明 |
|---|---|---|
文件路径 | 是 | 目标文本文件路径。 |
行数 | 是 | 需要覆盖写入的行号，可以是固定数字，也可以是变量表达式。 |
写入内容 | 是 | 要写入目标行的文字或变量内容，既可以是固定字符串，也可以是变量标签。 |
HardDisk | 否 | 实时读写物理硬盘；省略时优先操作当前内存中的文本内容。 |
返回或影响
- 该命令会把目标行内容覆盖为新的文本值。
- 它不是条件判断命令，不直接返回成功或失败分支结果。
- 带
HardDisk时，会立即把结果写入物理文件。 - 不带
HardDisk时，通常先修改当前内存中的文本状态。
示例
基础用法
#ACT
WriteLine ..\QuestDiary\排行榜\个人充值记录.ini 1 <$USERNAME>
这段写法会把排行文件第 1 行覆盖为当前角色名，适合重写固定槽位或刷新榜首展示。
常见变体
#ACT
WriteLine ..\QuestDiary\排行榜\个人充值记录.ini <$STR(M排行序号)> <$STR(S10)> HardDisk
这段写法会按变量指定的行号，把 S10 中的结果实时写回硬盘，适合排行重算或外部流程需要立即读取最新内容的场景。
注意事项
WriteLine是按行号覆盖写入，不会自动在末尾追加；如果需要追加新记录，应改用 AddLineList。- 文本操作命令本身比较消耗资源，频繁对大文件附带
HardDisk会明显增加 I/O 压力。