INI

重命名 INI 节

把指定 INI 节重命名为新的节名。

命令用途

Ini_Rename_Section 对应的实际命令写法是 INI_RENAME_SECTION,用于把指定 INI 节重命名为新的节名。

它常见于模块改名、配置迁移和需要整体保留节内键值但切换节名的场景。

命令名

Ini_Rename_Section

调用格式

INI_RENAME_SECTION <文件路径> <旧节名> <新节名>

参数说明

参数必填说明
文件路径是目标 INI 文件路径。
旧节名是当前已有的节名称。
新节名是重命名后的节名称。

返回或影响

  • 该命令会把指定节整体改名为新节名。
  • 节内已有键值会跟随节名一起迁移。
  • 这类修改不会自动落盘,通常还要配合 INI_SAVE。

示例

基础用法

#ACT
INI_RENAME_SECTION .\Activity.ini Reward RewardBackup
INI_SAVE .\Activity.ini

这段写法适合把 Reward 节整体改名为 RewardBackup 并立即保存文件。

注意事项

  • 这条命令改的是整个节名,不是单个键名。
  • 如果只想调整节内某个键,应改用 Ini_Delete_Key、Ini_Write_String 或相关写入命令。

相关命令