Функция IniWriteSection

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

IniWriteSection

Записывает секцию в ini-файл.

IniWriteSection('filename','section','data'[,index=1])

Параметры

filename	Путь к ini-файлу.
section	Имя секции в ini-файле.
data	Данные для записи. Может быть строкой или массивом. Если строка, то пары параметр=значение должны быть разделены символом @LF. Если массив, то он должен быть 2-мерным, а его второе измерение должно быть 2 элементным, то есть 2 колонки.
index	[необязательный] Если в качестве данных передаётся массив, то этот параметр указывает индекс первого элемента для записи. По умолчанию 1 для удобства работы с массивами, возвращёнными функцией IniReadSection(). При ручном создании массива индекс может быть другим, например 0. Этот параметр игнорируется, если данные передаются строкой.

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

Успех:	Возвращает 1.
Ошибка:	Возвращает 0. Значение @error устанавливается равным 1, если данные имеют неправильный формат.

Примечания

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

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

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

Если файл не существует, то он будет создан. Однако, если путь к каталогу, в котором создаётся ini-файл не существует, то каталоги не создаются и ini-файл не будет создан. Параметры и секции добавляются в конце (без какой-либо сортировки).
Если секция уже существует, его содержимое будет удалено перед записью.

Функцию можно подключить через команду exect

См. также

IniDelete, IniRead, IniReadSection, IniReadSectionNames, IniWrite, IniRenameSection

Примеры:
Как создать кнопку?

exect=IniWriteSection(EnvGet('COMMANDER_INI'),'WWW','k1=привет'&@LF&'k2=пока') ;; записать в Wincmd.ini в секцию [WWW] заданные ключи и значения