Функция IniWrite

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


IniWrite

Записывает значение параметра в стандартный ini-файл.

IniWrite ( "filename", "section", "key", "value" )

Параметры

filename Путь к ini-файлу.
section Имя секции в ini-файле.
key Имя параметра в ini-файле.
value Значение параметра для записи.

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

Успех:Возвращает 1.
Ошибка:Возвращает 0, если файл не доступен для записи.

Примечания

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

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


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

Если файл не существует, то он будет создан. Однако, если путь к каталогу, в котором создаётся ini-файл не существует, то каталоги не создаются и ini-файл не будет создан. Параметры и секции добавляются в конце (без какой-либо сортировки).
Чтобы записать данные, которые должны быть прочитаны с обрамляющими кавычками, они должны быть записаны в ini-файл с двойными кавычками, например key=""value"", тогда после чтения параметра одна пара крайних кавычек будет удалена.
При чтении значения, его начальные и конечные пробелы удаляются. Чтобы записать значение с пробелами по краям, необходимо записать значение в ini-файл в таком виде: key=" этот текст с пробелами по краям ", тогда текст прочитается с пробелами, а кавычки будут удалены.
Многострочные значения не поддерживаются.

См. также

IniDelete, IniRead, IniReadSection, IniReadSectionNames, IniWriteSection, IniRenameSection

Пример

$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)