Reads a value, section or list of section names from a standard format .ini file.
Value := IniRead(Filename, Section, Key , Default) Section := IniRead(Filename, Section) SectionNames := IniRead(Filename)
The name of the .ini file, which is assumed to be in A_WorkingDir if an absolute path isn't specified.
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).
The key name in the .ini file.
The value to return if the requested key, section or file is not found. If omitted, an exception is thrown on failure.
This function returns the actual value of the specified key. If the value cannot be retrieved, the default value indicated by the Default parameter is returned.
If the Key parameter is omitted, this function returns an entire section. Comments and empty lines are omitted. Only the first 65,533 characters of the section are retrieved.
If the Key and Section parameters are omitted, this function returns a linefeed (
`n) delimited list of section names.
An exception is thrown on failure only if Default is omitted.
Regardless of whether an exception is thrown, A_LastError is set to the result of the operating system's GetLastError() function.
The operating system automatically omits leading and trailing spaces/tabs from the retrieved string. To prevent this, enclose the string in single or double quote marks. The outermost set of single or double quote marks is also omitted, but any spaces inside the quote marks are preserved.
Values longer than 65,535 characters are likely to yield inconsistent results.
A standard ini file looks like:
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
Value := IniRead("C:\Temp\myfile.ini", "section2", "key") MsgBox "The value is " Value