RegularExpressions на MQL4 для работы с регулярными выражениями - библиотека для MetaTrader 4

RegularExpressions для MQL4 - реализация обработчика регулярных выражений .NET Framework 4.6.1.

Регулярные выражения предоставляют формальный язык для быстрой и гибкой обработки текста. Каждое регулярное выражение является шаблоном(маской), для которого обработчик регулярных выражений пытается найти совпадения в исходном текстом. Шаблон состоит из односимвольных или многосимвольных литералов, операторов или конструкций.

Для реализации обработчика регулярных выражений в .NET Framework используется традиционная NFA-машина (NonDeterministic Finite-state Automaton – недетерминированные конечные автоматы), которая  выполняет поиск с возвратом для регулярных выражений. Аналогичные обработчик регулярных выражений использовались в Perl, Python, Emacs и Tcl. Использование NFA-машины отличает его от более быстрых, но и менее функциональных DFA-машин (детерминированный конечный автомат), предназначенных только для регулярных выражений и используемых в awk, egrep или lex.

Обработчик регулярных выражений .NET Framework имеет в себе основные функции NFA-машины, а также полный набор структурных элементов, позволяющий управлять процессом поиска с возвратом. Используя данные структуры программист имеет возможность для существенного ускорения поиска или для выбора предпочтительных расширений.

Основные возможности обработчика регулярных выражений .NET Framework:

    Ленивые кванторы: ??, *?, +?, {n,m}?.
    Положительный поиск: (?=subexpression).
    Отрицательный поиск: (?!subexpression).
    Условная оценка: (?(expression)yes|no) and (?(name)yes"> no ) и (?(name)yes|no) ).
    Сбалансированные определения групп: (?<name1-name2> subexpression).
    Не возвращающаяся ("жадная") часть выражения: (?>subexpression).
    Поиск совпадений справа налево. Для этого в метод сопоставления статических экземпляров или в сам конструктор класса Regex передаем параметер RegexOptions::RightToLeft.
    Положительный и отрицательный поиск назад: (?<=subexpression) для положительного поиска назад и (?<!subexpression) для отрицательного поиска назад.

С данной библиотекой все эти возможности будут доступны средствами языка MQL4.

Описание:

Здесь представлен перевод RegularExpressions c .Net Framework 4.6.1.

Для работы с библиотекой необходимо подключить к вашему коду файл Regex.mqh из директории \MQL4\Include\RegularExpressions\.

Также вместе с библиотекой прилагается несколько демонстрационных примеров, одновременно выполняющих роль тест-кейсов. Все примеры взяты с официального сайта Microsoft Corporation, они наглядно показывают основные отличия от регулярных выражений на C# и особенности использования их на MQL4.

Подробнее о пакетах портированной библиотеки RegularExpressions MQL4:

Параметры регулярных выражений из файла RegexOptions.mqh:

Особенности работы с RegularExpressions для MQL4:

1. Как и в версии под .Net, в данной библиотеке реализовано хранилище (статическая кэш-память) регулярных выражений. Все неявно созданные регулярные выражения (экземпляры класса Regex) заносятся в это хранилище. Данный подход ускоряет работу скриптов, так отпадает необходимость заново строить регулярные выражения, если его шаблон совпадает с одним из уже имеющихся. По умолчанию размер хранилища равен 15. Метод Regex::CacheSize() возвращает или задаёт максимальное количество записей в текущей статической кэш-памяти скомпилированных регулярных выражений.
   
2. Вторая особенность при работе с регулярными выражениями на MQL4 непосредственно вытекает из первой. И заключается она в том, что вышеупомянутое хранилище необходимо чистить. Для этого необходимо вызвать статическую функцию Regex::ClearCache(). Данную функцию рекомендуется вызвать только после того, как вы закончили работу с регулярными выражениями, иначе велика вероятность удалить нужные указатели.
3. В отличие от .Net, в MQL4 не реализован цикл foreach, а следовательно, и работа с перечислениями будет отличаться. Пример:

   //--- Код на C#
   Regex rx = new Regex(@"\b(?<word>\w+)\s+(\k<word>)\b", RegexOptions.IgnoreCase);   
   string text = "The the quick brown fox  fox jumped over the lazy dog dog.";
   MatchCollection matches = rx.Matches(text);
   foreach (Match match in matches) 
     {
      //--- обработка
     }
   

   //--- Код на MQL4
   Regex *rx = new Regex("\\b(?<word>\\w+)\\s+(\\k<word>)\\b", RegexOptions::IgnoreCase);        
   string text = "The the quick brown fox  fox jumped over the lazy dog dog.";
   MatchCollection *matches = rx.Matches(text);
   IEnumerator<Match*> *en = matches.GetEnumerator();
   while(en.MoveNext()) 
     {
      Match *match = en.Current();
      //--- обработка
     }
   delete rx;
   delete matches;
   delete en;
   Regex::ClearCache();

4. Как видно из примера выше, синтаксис языка C# позволяет ставить перед строками символ '@' для игнорирования всех знаков форматирования в ней. В MQL4 такой подход не предусмотрен, поэтому все управляющие символы в шаблоне регулярных выражений нужно прописывать явно.

Для более подробного ознакомления с библиотекой RegularExpressions для MQL4 и её возможностями создан эксперт Tests.mqh. В нем реализовано больше количество примеров использования регулярных выражений, затрагивающие весь основной функционал библиотеки.