Writes a value or section to a standard format .ini file.
IniWrite Value, Filename, Section, Key IniWrite Pairs, Filename, Section
Type: String
The string or number that will be written to the right of Key's equal sign (=).
If the text is long, it can be broken up into several shorter lines by means of a continuation section, which might improve readability and maintainability.
Type: String
The complete content of a section to write to the .ini file, excluding the [SectionName] header. Key must be omitted. Pairs must not contain any blank lines. If the section already exists, everything up to the last key=value pair is overwritten. Pairs can contain lines without an equal sign (=), but this may produce inconsistent results. Comments can be written to the file but are stripped out when they are read back by IniRead.
Type: String
The name of the .ini file, which is assumed to be in A_WorkingDir if an absolute path isn't specified.
Type: String
The section name in the .ini file, which is the heading phrase that appears in square brackets (do not include the brackets in this parameter).
Type: String
The key name in the .ini file.
An OSError is thrown on failure.
Regardless of whether an exception is thrown, A_LastError is set to the result of the operating system's GetLastError() function.
Values longer than 65,535 characters can be written to the file, but may produce inconsistent results as they usually cannot be read correctly by IniRead or other applications.
A standard ini file looks like:
[SectionName] Key=Value
New files are created with a UTF-16 byte order mark to ensure that the full range of Unicode characters can be used. If this is undesired, ensure the file exists before calling IniWrite. For example:
; Create a file with ANSI encoding. FileAppend "", "NonUnicode.ini", "CP0" ; Create a UTF-16 file without byte order mark. FileAppend "[SectionName]`n", "Unicode.ini", "UTF-16-RAW"
Unicode: IniRead and IniWrite rely on the external functions GetPrivateProfileString and WritePrivateProfileString to read and write values. These functions support Unicode only in UTF-16 files; all other files are assumed to use the system's default ANSI code page.