RegularExpressions na MQL4 para trabalhar com expressões regulares - biblioteca para MetaTrader 4

Verdadeiro autor:

Microsoft Corporation. Os códigos fonte foram tirados do .Net Framework 4.6.1. 

Aqui você dispõe de uma tradução do RegularExpressions com .Net Framework 4.6.1.

Para usar a biblioteca, você deve conectar ao seu código o arquivo Regex.mqh do diretório \MQL4\Include\RegularExpressions\.

Além disso, juntamente com a biblioteca existem várias demonstrações que ao mesmo tempo cumprem o papel de casos exemplares. Todos os exemplos são tirados do site oficial Microsoft Corporation, eles mostram claramente as principais diferenças de expressões regulares no C# e as peculiaridades do seu uso na MQL4.

Leia mais sobre os pacotes da biblioteca migrada (portada) RegularExpressions MQL4:

Parâmetros de expressões regulares a partir do arquivo RegexOptions.mqh:

Características do trabalho com RegularExpressions para MQL4:

1. Como na versão .Net, nesta biblioteca foi empregue um repositório (memória cache invariável) de expressões regulares. Todas as expressões regulares criadas implicitamente (modelos da classe Regex) são inseridas neste repositório. Esta abordagem acelera o trabalho dos scripts, pois desaparece a necessidade de construir de novo expressões regulares, já que o seu padrão corresponde a um dos já existentes. O tamanho do repositório é por defeito 15. O método Regex::CacheSize() retorna ou define o número máximo de entradas na atual memória cache invariável das expressões regulares compiladas.
   
2. A segunda característica, quando se trabalha com expressões regulares na MQL4, resulta diretamente a partir da primeira. E trata-se do fato de que o repositório acima mencionado deve ser limpo. Para fazer isso, é preciso chamar a função invariável Regex::ClearCache(). É recomendável chamar essa função somente após terminar de trabalhar com expressões regulares, caso contrário, é muito provável que se esteja removendo indicadores necessários.
3. Ao contrario do .Net, na MQL4 não está empregue o ciclo foreach e, conseqüentemente, o trabalho com enumerações é diferente. Exemplo:

   //--- Código em 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) 
     {
      //--- processamento
     }
   
   //--- Código para 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();
      //--- processamento
     }
   delete rx;
   delete matches;
   delete en;
   Regex::ClearCache();
   

4. Como você pode ver no exemplo acima, a sintaxe da linguagem C# permite colocar diante das linhas o caractere '@' para ignorar todas as marcas de formatação nele. Na MQL4, tal abordagem ainda não tem sido coberta, de modo que todos os caracteres de controle, num padrão de expressão regular, devem ser descritos claramente.

Ao trabalhar com esta forma, nós escolhemos a tabela do nosso interesse, selecionamos a coluna e o valor nela, de acordo com o qual a tabela será filtrada. Clicamos no botão Find e a tabela filtrada será mostrada abaixo, juntamente com algumas estatísticas sobre ela. O botão Save salva a tabela, que está sendo exibida atualmente, num arquivo csv. O arquivo salvo será também colocado na área local com o nome Result.csv.

Para saber mais sobre a biblioteca RegularExpressions para MQL4 foi criado o conselheiro Tests.mqh. Ele contem exemplos para utilizar expressões regulares que atingem toda a funcionalidade básica da biblioteca.