ParserIni.dll v4.2.11.0 - библиотека для MetaTrader 4

Описание:

Скайп-чат поддержки продукта: skype:?chat&blob=ltRdjnFp09LOGpvbkyqno-pOvnKg-u4uFdin6S_NyAMmswdjwR7chyV729g9
Последние версии библиотек, скриптов и приложений: ftp://zhunko_Guest:abd4vsuc@ftp.zhunko.ru

Ещё одно решение для работы с INI-файлами.

От аналогов отличается:
1. Есть возможность записи/чтения массивов до 3-х измерений.
2. Можно применять любые теги разделов. Даже непарные.
3. Есть синхронизация работы с текущим файлом из разных процессов.
4. Самое главное! Библиотека работает не с файлом на диске, а с его копией в памяти. Т.е. Библиотека один раз читает файл в память, затем анализ текста, потом закрывает файл. Это быстро и не мучает диск.
5. Есть возможность использовать привычные программисту комментарии.
6. Встроен автоматический контроль текста файла на ошибки. Если есть ошибки, парсер показывает ошибки в диалоговом окне. Может пригодиться для ручного заполнения файла.
7. Все ошибки комментируются, неточности исправляются и перед закрытием файла он перезаписывается исправленным текстом. Такой маленький "компилятор".
8. Можно записывать и перезаписывать заголовок файла отдельной функцией.
9. Есть выбор кодировки файла (ANSI/UNICODE).

Комплект:

1. Заголовочный файл функций библиотеки "ParserIni.mqh".
2. Тестовый скрипт с примерами "Check_ParserIni.dll.mq4".
3. Папка с файлами "ParserIni.h" и "ParserIni.lib" для подключения библиотеки к C++ проектам.
4. Архив со всем вышеперечисленным и DLL, разложеным по папкам.

Правила парсера :

1. ОБЩИЕ ПОЛОЖЕНИЯ.
1.1. Первая строка текста может быть заголовком. Можно записать туда что-нибудь полезное с обязательным комментарием ("//").
1.2. Последний символ текста должен быть комбинацией знаков перевода каретки и переноса строки ("\r\n").
1.3. Пара ключ-значение всегда начинается с новой строки.
1.4. Между ключом и его значением должен стоять символ равно ("=").
1.5. Ключи и их значения регистрозависимы.
2. КЛЮЧИ.
2.1. Ключи могут состоять из любых символов, кроме символов типографики, знаков пунктуации, математических знаков и зарезервированного слова "End".
3. ЗНАЧЕНИЯ КЛЮЧЕЙ.
3.1. Значение ключа может состоять только из букв латинского алфавита, букв русского алфавита, цифр, знаков пунктуации и разделителей слов (пробел (" ")).
3.2. Значение ключа может быть равным пустой строке.
3.3. Если применяется метод, возвращающий число, к пустой строке, то он возвращает ноль.
3.4. Значения ключа могут перечисляться через вертикальную черту ("|"), точку с запятой (";") и запятую (","). Это означает набор значений (массив значений) для первого, второго и третьего измерений массива соответственно. Последние символы (","), (";"), ("|") ставить не обязательно.
Пример записывает одномерный массив: Param=1,2,3,4,5,6,7,8,9
Пример записывает двухмерный массив: Param=1,2,3;4,5,6;7,8,9
Пример записи трёхмерного массива: Param=1,2,3;4,5,6;7,8,9|1,2,3;4,5,6;7,8,9|1,2,3;4,5,6;7,8,9
3.5. Число может иметь первым символом знак плюс ("+") или минус ("-").
3.6. Значение ключа всегда заканчивается комбинацией знаков перевода каретки и переноса строки ("\r\n").
4. КОММЕНТАРИИ.
4.1. Возможны комментарии типа ("//") и ("/**/").
4.2. Комментарии синтаксическим анализом игнорируются.
5. РАЗДЕЛЫ.
5.1. Имя раздела может состоять из любых символов, кроме текущих символов открывающего и закрывающего тегов раздела.
5.2. Имя раздела ограничивается двумя любыми символами.
5.3. Парсер может работать с любым количеством обозначений разделов.
5.4. При инициализации перечисление тегов разделов выглядит, как строка, где в каждой паре ячеек указывается открывающий и закрывающий имя раздела теги. Пример: "# []". Если закрывающий тег является пустой строкой, то необходимо вместо него указать пробел. Открывающий тег не может быть пробелом.
5.5. Возможны два варианта обозначения раздела по умолчанию.
Вариант 1. Блок раздела начинается с новой строки с символа ("#") и продолжается уникальным пользовательским именем и завершается пустой строкой (""). Пример: #UserSpace0.
Вариант 2. Блок раздела начинается с новой строки с символа ("["), продолжается уникальным пользовательским именем и завершается символом ("]"). Пример: [UserSpace0].
5.6. Парсер выбирает первое встретившееся из перечисленных обозначений разделов. Другие игнорирует и комментирует.
5.7. Завершается блок раздела началом следующего блока другого раздела или тегом ("#End") для первого варианта и ("[End]") для второго варианта.
5.8. Если был установлен раздел, то перед применением любого метода чтения или установки пары ключ-значение необходимо вызвать метод установки или чтения раздела.
5.9. Нельзя использовать для имени раздела зарезервированное слово "End".
6. ПАРСЕР.
6.1. Все одинокие знаки перевода каретки ("\r") и знаки переноса строки ("\n") дополняются до комбинации --> ("\r\n").
6.2. После комментариев типа ("/**/") и до комбинации знаков перевода каретки и переноса строки ("\r\n") все символы переносятся на новую строку.
6.3. Пробелы и знаки табуляции удаляются только из строк с парами ключ-значение.
6.4. Пробелы и знаки табуляции удаляются из значения ключа только спереди от знака равно ("=") и сзади значения до комбинации ("\r\n").
6.5. Повторные записи уже существующих ключей внутри одного раздела парсером автоматически комментируются ("//").
6.6. Повторные записи уже существующих разделов парсером автоматически комментируются ("//").