Reads a value from a standard format .ini file.
IniRead, OutputVar, Filename [, Section, Key, Default]
OutputVar |
The name of the variable in which to store the retrieved value. If the value cannot be retrieved, the variable is set to the value indicated by the Default parameter (described below). [AHK_L 57+]: If Key is omitted, the contents of the specified Section are retrieved excluding any comments. If Section is also omitted, OutputVar receives a list of section names where each name is separated by a linefeed character ( |
Filename | The name of the .ini file, which is assumed to be in %A_WorkingDir% if an absolute path isn't specified. |
Section | 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). |
Key | The key name in the .ini file. |
Default | The value to store in OutputVar if the requested key is not found. If omitted, it defaults to the word ERROR. To store a blank value (empty string), specify %A_Space%. [AHK_L 57+]: This parameter is not used if Key is omitted. |
ErrorLevel is not set by this command. If there was a problem, OutputVar will be set to the Default value as described above.
The operating system automatically omits leading and trailing spaces/tabs from the retrieved string.
A standard ini file looks like:
[SectionName] Key=Value
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.
IniDelete, IniWrite, RegRead, file-reading loop, FileRead
IniRead, OutputVar, C:\Temp\myfile.ini, section2, key MsgBox, The value is %OutputVar%.