Функция IniRead

         Описание функции


IniRead

Считывает значение параметра из стандартного ini-файла

IniRead ( "filename", "section", "key", "default" )

Параметры

filename Путь к ini-файлу.
section Имя секции в ini-файле.
key Имя параметра в ini-файле.
default Значение по умолчанию (будет возвращено, если указанный параметр не найден).

Возвращаемое значение

Успех:Возвращает значение указанного параметра в виде строки.
Ошибка:Возвращает строку указанную в параметре default, если указанный параметр не найден.

Примечания

Стандартный ini-файл имеет следующую структуру:

[Имя секции]
Параметр=Значение


Если необходимо использовать ini в формате юникода, то предварительно создайте ini-файл с помощью FileOpen() с кодировкой "Unicode UTF16 Little Endian".

Значение параметра default преобразуется в строку, если не является таковым. Функция IniRead всегда возвращает строковый тип данных. Поэтому, если вам нужно число, то используйте функции преобразования, такие как Number() и т.д.

См. также

IniDelete, IniWrite, FileReadLine, IniReadSection, IniReadSectionNames, IniRenameSection, IniWriteSection

Пример

$sPath_ini = @ScriptDir & "\Example.ini"

; Записывает значение 'Это новое значение' в параметр 'Key' в секцию 'Section'.
IniWrite($sPath_ini, "Section", "Key", "Это новое значение")

; Читает из INI-файла параметр 'Key' в секции 'Section'.
$sRead = IniRead($sPath_ini, "Section", "Key", "Значение по умолчанию")

MsgBox(4096, "", "Значение параметра 'Key' в секции 'Section': " & $sRead)

; Удаляет параметр 'Key'.
IniDelete($sPath_ini, "Section", "Key")

; Читает из INI-файла параметр 'Key' в секции 'Section'.
$sRead = IniRead($sPath_ini, "Section", "Key", "Значение по умолчанию")

; При отсутствии ключа возвращается значение по умолчанию
MsgBox(4096, "", "Значение параметра 'Key' в секции 'Section': " & $sRead)

; Удаляет INI-файл.
FileDelete($sPath_ini)

; $var = IniRead("C:\Boot.ini", "boot loader", "timeout", "Не найдено")
; MsgBox(4096, "Результат", $var)