RegularExpressions in MQL4 per lavorare con le espressioni regolari - libreria per MetaTrader 4

Autore:

Microsoft Corporation. Il codice sorgente è stato preso da .Net Framework 4.6.1. 

Qui c'è una traduzione della RegularExpressions da .Net Framework 4.6.1.

Per lavorare con la libreria, includere il file Regex.mqh dalla directory "\MQL4\Include\RegularExpressions\" nel tuo codice.

Con la libreria sono forniti diversi esempi illustrativi, che allo stesso tempo fungono da casi test. Tutti gli esempi sono stati presi dal sito ufficiale di Microsoft Corporation, dimostrano chiaramente le principali differenze dalle espressioni regolari in C# e le caratteristiche del loro utilizzo in MQL4.

Di seguito informazioni più dettagliate circa i pacchetti della libreria RegularExpressions portata a MQL4:

I parametri delle espressioni regolari dal file RegexOptions.mqh:

Lavorando con RegularExpressions per MQL4:

1. Come con la versione per .Net, questa libreria implementa una memorizzazione (cache statica) di espressioni regolari. Tutte le espressioni regolari create implicitamente (istanze della classe Regex) vengono scritte in quella memoria. Questo approccio velocizza il funzionamento degli script, in quanto elimina la necessità di ricostruire l'espressione regolare se il suo pattern corrisponde a uno di quelli esistenti. La dimensione predefinita della memoria è 15. Il metodo Regex::CacheSize() restituisce o imposta il numero massimo di voci nell'attuale cache statica delle espressioni regolari rispettate.
   
2. La seconda caratteristica di lavorare con le espressioni regolari in MQL4 segue direttamente dalla prima. E sta nel fatto che la memoria di cui sopra deve essere cancellata. Per fare questo, chiamare la funzione statica Regex::ClearCache(). E' raccomandato chiamare questa funzione solo dopo che il lavoro con l'espressione regolare è stato completato, altrimenti c'è il rischio di cancellare i puntatori necessari.
3. A differenza di .Net, MQL4 non implementa il ciclo foreach e quindi la gestione dell'enumerazione sarà diversa. Esempio:

   //--- Code in 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) 
     {
      //--- handling
     }
   
   //--- Code in 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();
      //--- handling
     }
   delete rx;
   delete matches;
   delete en;
   Regex::ClearCache();
   

4. Come si può notare dall'esempio sopra, la sintassi del C# consente di inserire il simbolo "@" davanti alle stringhe per ignorare tutti i segni di formattazzione in esso. In MQL4, questo approccio non è fornito, quindi tutti i caratteri di controllo in un modello di espressione regolare dovrebbero essere definiti in modo esplicito.

Per ulteriori informazioni su RegularExpressions per MQL4 e sulle sue funzionalità, utilizza l'esperto Tests.mqh fornito. Implementa numerosi esempi di utilizzo delle espressioni regolari, che coprono tutte le principali funzionalità della libreria.