Функция 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-файл с использованием функции Chr(), например key=Chr(34)&'value'&Chr(34)
Многострочные значения не поддерживаются.

Функцию можно подключить через команду exect
Для передачи пустой строки можно воспользоваться ключевым словом Null

См. также

IniDelete, IniRead, IniReadSection, IniReadSectionNames, IniWriteSection, IniRenameSection

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

exect=IniWrite(EnvGet('COMMANDER_INI'),'WWW','Key','Это~~новое~~значение') ;; записать в файл Wincmd.ini в секцию [WWW] в ключ Key заданное значение

exect=IniWrite(EnvGet('COMMANDER_INI'),'WWW','Key',Chr(34)&'Это~~новое~~значение'&Chr(34)) ;; записать в файл Wincmd.ini в секцию [WWW] в ключ Key заданное значение в кавычках

exect=$var_a=StringSplit('%%COMMANDER_PATH%%\Bar\000_TCIMG_Test.bar|%%COMMANDER_PATH%%\Bar\084_AU3.bar|%%COMMANDER_PATH%%\Bar\000_TCIMG_Test_Exe.bar','|')||$var_si=EnvGet('COMMANDER_PATH')&'\WinButtonBar.ini'||$var_sb=IniRead('$var_si','Buttonbar','Buttonbar',Null)||$var_i=Number(_ArraySearch($var_a,'$var_sb')+1)||$var_i=($var_i>3~~Or~~$var_i=0)?1:$var_i||IniWrite('$var_si','Buttonbar','Buttonbar','$var_a[$var_i]')||IniWrite('$var_si','Buttonbar','Buttonbar',Execute('$var_a[$var_i]')) ;; записать один из 3-х заданных путей .bar по кругу в WinButtonBar.ini в секцию [Buttonbar]

exect=$var_a=StringSplit(StringReplace('??%%COMMANDER_PATH%%\TCIMG.exe?~~?openup??|??%%COMMANDER_PATH%%\Utilities\TotalCom\ChoiceEditor\ChoiceEditor.exe??','?',Chr(34)),'|')||$var_sc=EnvGet('COMMANDER_INI')||$var_sp=IniRead('$var_sc','Configuration','Editor',Null)||$var_is=StringInStr('$var_sp','TCIMG')?2:1||IniWrite('$var_sc','Configuration','Editor',$var_a[$var_is]) rstart ;; переключение программы просмотра по F4 с перезагрузкой

exect=IniWrite(EnvGet('COMMANDER_INI'),'WWW','Key',Null) ;; записать в файл Wincmd.ini в секцию [WWW] ключ Key без значения