GTA-LOVE | Всё о Gta: San Andreas, SA-MP, MTA Файловый архив

Что это за скрипт

Это релиз инклуд-файла с инструментами для самого быстрого чтения/записи INI файлов. Более того, этот инклуд не нуждается в настройке. Вы подключаете его в ФС или МОД и можно сразу читать/записывать INI файлы.

Преимущества

Свободный формат
Во-первых, оформлять ваши INI файлы вы можете как угодно - криво/ровно, с отступами/без, с комментами/без, с любыми пробельными символами вокруг =. И это все никак не влияет на чтение/запись. Нет никаких лимитов на длину ключей или значений. Ключи и значения можно писать даже по-русски. В имени ключа/значении можно использовать любые символы кроме \r и\n. Пробелы и знаки табуляции вокруг имени ключа, вокруг символа = и перед текстовым значением считаются отступами. В одной строке вы можете поместить любое кол-во пар ключ/значение, включая всевозможные варианты оформления.
Свободное расположение комментов
Чтобы увеличить скорость чтения, считается, что любые строки, где нет символа = это комментарии. Также комментарием может быть любой текст, все зависит от вашего форматирования.
Скорость
Перед тем как читать что-то из INI файла, его также как и остальные файлы нужно открыть. При открытии весь файл копируется в ОЗУ вместе с именем. Остальные операции чтения/записи производятся непосредственно в ОЗУ. Именно поэтому все это происходит очень быстро. Если контент файла в ОЗУ был изменен, при закрытии он будет записан на диск.

Еще 1 плюс, который ранее в скриптинге не применялся - это сжатое хранение контента файла, что в 4 раза меньше, чем обычный формат. Скорость также достигается за счет отсутствия дополнительных функций, которые могли бы использоваться в функциях чтения/записи, а также за счет использования только встроенных функций скриптинга.

Инструменты

ini_createFile ( "путь/к/файлу.ini", "Содержимое файла по умолчанию" )
ini_openFile ( "путь/к/файлу.ini" )
ini_closeFile ( ИД_открытого_файла )

ini_setString ( ИД_открытого_файла, "имя ключа", "текстовое значение" )
ini_setInteger ( ИД_открытого_файла, "имя ключа", 123456 )
ini_setFloat ( ИД_открытого_файла, "имя ключа", 3.1416 )

ini_getString ( ИД_открытого_файла, "имя ключа", returnValue )
ini_getInteger ( ИД_открытого_файла, "имя ключа", returnValue )
ini_getFloat ( ИД_открытого_файла, "имя ключа", returnValue )

ini_removeKey ( ИД_открытого_файла, "имя ключа" )
ini_getErrorInfo ( Код_ошибки )

Примеры

Code

new iniFile = ini_createFile ( "test4268.ini" ); if ( iniFile < 0 ) iniFile = ini_openFile ( "test4268.ini" ); if ( iniFile >= 0 ) { new returnString[32], returnNumber, Float: returnFloat; ini_setString ( iniFile, "ключ со строкой", "текстовое значение" ); ini_setInteger ( iniFile, "ключ с числом", 123456 ); ini_setFloat ( iniFile, "ключ с дробью", 3.1416 ); ini_removeKey ( iniFile, "ключ с числом" ); ini_getString ( iniFile, "ключ со строкой", returnString ); ini_getInteger ( iniFile, "ключ с числом", returnNumber ); ini_getFloat ( iniFile, "ключ с дробью", returnFloat ); ini_closeFile ( iniFile ); printf ( "\n `ключ_со_строкой` = `%s`,\n `ключ_с_числом` = `%d`,\n `ключ_с_дробью` = `%f` \n", returnString, returnNumber, returnFloat ); } else print( "\n Не удалось открыть INI файл \n" );

Тест

ТЕСТ скорости 2-х библиотек, которые ориентированы исключительно
на чтение/запись в файлы INI формата.

Тестируются: Dini, mxINI

Для тестирования из библиотек будут использоваться только самые быстрые
функции чтения/записи для строк, т.к. скорость преобразования типов зависит
не от инструментов библиотеки, а от встроенных функций скриптинга.

Каждой библиотеке нужно будет создать и открыть INI файл, записать в него 100 ключей,
прочесть значения этих ключей, закрыть файл.

Это результаты выполнения вышеуказанных операций. Сравните их.

1 секунда = 1000 милисекунд (мсек)