Метод AddIniAny используется для записи, изменения и чтения значения целочисленной переменной из ini-файла. В отличие от метода AddIni, в AddIniAny можно задать секцию файла, в которой находится целочисленная переменная. Метод возвращает значение переменной, полученное после изменения.
Синтаксис обращения к методу:
function AddIniAny(varName: String, varValue: int, path: String, section: String): int
- varName – обязательный аргумент. Задает имя переменной в файле.
- varValue – обязательный аргумент. Задает значение переменной либо значение, которое следует добавить к существующему значению переменной:
- Если в файле хранится переменная с именем varName и строковым значением, переменной будет присвоено значение varValue.
- Если в файле нет переменной с именем varName, будет создана такая переменная, и ей будет присвоено значение varValue.
- Если в файле хранится переменная с именем varName, которая имеет целочисленное значение, или же значение ее приводится к целочисленному типу, то значение будет приведено, и к нему будет прибавлено varValue.
- path – обязательный аргумент. Задает полный путь к файлу ini, в котором должна храниться переменная. Хранилище переменных можно поместить на сетевом ресурсе, для этого следует задать сетевой путь.
- section – обязательный аргумент. Задает название секции ini-файла, в которой находится переменная.
Пример. В секции "config" файла "C:\test.ini" нет переменной "MyVar". Записать в секцию данного файла такую переменную со значением -1, прибавить к ней 1 и вывести полученное значение в отладочное окно скрипта.
var result = AddIniAny("MyVar", -1, "C:\\test.ini", "config");
result = AddIniAny("MyVar", 1, "C:\\test.ini", "config");
DebugLogString(result);