Встроенная библиотека для работы с ini-файлами. Позволяет читать и записывать файлы конфигурации в формате ini, реализуется это с помощью двух функций load и save.
Добавлена в v.018.
table data = inicfg.load([table default], [string file])
Функция загружает все параметры из ini-файла и записывает их в таблицу с сохранением иерархии секций, ключей и значений. Имеет два опциональных параметра: первый (default) - задаёт таблицу со значениями по умолчанию, которые будут использованы, если в конфигурационном файле они отсутствуют или отсутствует сам файл; второй - путь к файлу (поиск файла производится в таком порядке: рабочая директория\config\указанный путь.ini -> рабочая директория\config\указанный путь -> указанный (абсолютный) путь), если путь к файлу не указан, то будет использован рабочая директория\config\имя_файла_скрипта.ini. Возвращает таблицу с данными.
bool result = inicfg.save(table data, [string file])
Записывает таблицу в ini-файл, сохраняя иерархию секция-ключ-значение. Имеет два параметра: data - таблица с секциями и значениями, и опциональный параметр, определяющий путь к файлу (см. выше). Возвращает true, если запись прошла успешно, в противном случае возвращает false.
{
section1 = {key1 = value1, key2 = value2 ...},
section2 = {key3 = value3 ...}
...
}
example.lua:
local inicfg = require 'inicfg'
-- производить загрузку кофигов можно и вне 'main'
local mainIni = inicfg.load({
settings =
{
title = "text",
text_color = "0xAABBCC"
},
location =
{
width = 100,
height = 200,
pos_x = 20,
pos_y = 50
}
}) -- загрузим основной конфиг. путь к файлу не указан, а значит будет загружен файл по пути ./moonloader/config/example.lua.ini
function main()
-- таблица со значениями по умолчаниями не указана, поэтому если файл не удастся прочитать, будет возвращён nil
local anotherIni = inicfg.load(nil, "example_another_config")
-- если файл был успешно загружен
if anotherIni ~= nil then
-- выводим прочитанные значения
print("Old value 1 = " .. anotherIni.main.value1)
print("Old value 2 = " .. anotherIni.main.value2)
-- просто сгенерируем 2 случайных значения
local newV1, newV2 = math.random(100, 1000), math.random(100, 1000)
-- теперь создадим таблицу с новыми значениями
local newData = {
main = {
value1 = newV1,
value2 = newV2,
-- и добавим к ним сумму этих двух значений
sum = newV1 + newV2
}
}
-- можно сохранять
if inicfg.save(newData, "example_another_config") then
print("Success.")
end
end
-- выведем основной конфиг
print(mainIni.settings.title .. ", color = " .. mainIni.settings.text_color)
print("Position: ", mainIni.location.pos_x, mainIni.location.pos_y, "Size: ", mainIni.location.width, mainIni.location.height)
-- отредактируем и сохраним его
mainIni.settings.title = "Hello"
mainIni.location.pos_x = 100
mainIni.location.pos_y = 75
inicfg.save(mainIni)
end
В результате выполнения этого кода будет создан файл example.lua.ini, содержащий все значения по умолчанию и изменённые значения title, pos_x, pos_y:
[settings]
title=Hello
text_color=0xAABBCC
[location]
width=100
height=200
pos_x=100
pos_y=75
При условии, что файл 'example_another_config.ini' будет находится в поддиректории 'config', он тоже будет прочитан и обработан - значения 'value1' и 'value2' из секции 'main' будут выведены, а затем будут сгененрированы новые случайные значения, вычислится их сумма и всё это запишется в тот же файл. Результат выйдет примерно такой:
[main]
value1=312
value2=591
sum=903