IniWrite

写入值到标准格式的 .ini 文件。

IniWrite, Value, Filename, Section [, Key]

参数

值

将被写入到 Key 的等号 (=) 右边的字符串或数字. 如果文本较长, 可以通过 延续片段 的方法将其分解成较短的几行, 这样可以增加可读性和可维护性.

[AHK_L 57+]: 如果省略 Key, 那么此参数应该包含要写入到 .ini 文件的全部的段内容, 不包括 [SectionName] 标题.

Filename

.ini 文件名, 如果未指定绝对路径则假定在 %A_WorkingDir% 中.

Section

.ini 文件中的段名, 它是包含在方括号中的标题短语 (在此参数中不需要加方括号).

键

.ini 文件中的键名.

ErrorLevel

[v1.1.04+] 此命令失败时会抛出异常. 想了解更多信息, 请参阅 运行时错误.

如果遇到问题则 ErrorLevel 被置为 1, 否则为 0.

备注

超过 65,535 字符的值很可能被截短。

标准的 ini 文件看起来类似下面这样:

[SectionName]
Key=Value

Unicode: IniRead 和 IniWrite 依靠外部函数 GetPrivateProfileString 和 WritePrivateProfileString 来读取和写入值. 这些函数仅支持 UTF-16 编码的 Unicode 文件; 其他所有文件都被认为使用系统默认 ANSI 代码页. 在 Unicode 脚本 中, IniWrite 为每个新文件使用 UTF-16 编码. 如果不希望这样, 那么请确保在执行 IniWrite 前目标文件已经存在. 例如：

FileAppend,, NonUnicode.ini, CP0 ; 在大多数情况下最后一个参数是可选的.

相关

IniDelete, IniRead, RegWrite

示例

IniWrite, this is a new value, C:\Temp\myfile.ini, section2, key