Оригинал статьи в AutoHotkey.chm: "IniRead", в содержании - "File, Directory and Disk Management" - "IniRead", v1.0.46.14.

Ник переводчика: YMP.

Настоящее имя переводчика: Юрий Попов.

IniRead

Читает значение параметра из INI-файла стандартного формата.

IniRead, OutputVar, Filename, Section, Key [, Default]

Параметры

OutputVar	Имя переменной, куда будет сохранено считанное значение. Если оно не может быть прочитано, в переменную будет помещено значение, указанное в параметре Default (описан ниже).
Filename	Имя файла .ini. Если не задан полный путь, файл ищется в папке, указанной в переменной A_WorkingDir.
Section	Имя раздела в файле .ini, которое представляет из себя заголовок в квадратных скобках (не включайте скобки в этот параметр).
Key	Имя параметра в файле .ini.
Default	Значение, которое будет помещено в OutputVar, если запрошенный параметр не найден. Если не указано, будет использовано слово ERROR. Чтобы задать пустую строку, используйте значение %A_Space%. Для скриптов AutoIt (.aut), по соображениям совместимости, этот параметр не поддерживается; слово ERROR будет в OutputVar всегда, когда возникают проблемы с чтением параметра из файла .ini.

ErrorLevel этой командой не изменяется. Если возникают проблемы, в OutputVar помещается значение, указанное в Default, как описано выше.

Операционная система автоматически опускает пробелы/табуляции в начале и конце считанной строки.

Стандартный INI-файл выглядит так:

[ИмяРаздела]
Параметр=Значение

IniRead, OutputVar, C:\Temp\myfile.ini, section2, key
MsgBox, Значение параметра: %OutputVar%.