RegularExpressions dans MQL4 pour travailler avec des expressions régulières - bibliothèque pour MetaTrader 4

Véritable auteur :

Microsoft Corporation. Code source extrait de .Net Framework 4.6.1. 

Voici une traduction des RegularExpressions de .Net Framework 4.6.1.

Pour travailler avec la bibliothèque, incluez le fichier Regex.mqh du répertoire "\MQL4\Include\RegularExpressions\" dans votre code.

Plusieurs exemples illustratifs sont fournis avec la bibliothèque, qui servent en même temps de cas de test. Tous les échantillons sont tirés du site officiel de Microsoft Corporation, ils démontrent de manière frappante les principales différences par rapport aux expressions régulières en C# et les fonctionnalités de leur utilisation dans le MQL4.

Vous trouverez ci-dessous des informations plus détaillées sur les packages de bibliothèques portés par RegularExpressions MQL4 :

Les paramètres d'expression régulière du fichier RegexOptions.mqh :

Travailler avec RegularExpressions pour MQL4 :

1. Comme pour la version pour .Net, cette bibliothèque implémente un stockage (cache statique) d'expressions régulières. Toutes les expressions régulières créées implicitement (instances de la classe Regex) sont écrites dans ce stockage. Cette approche accélère le fonctionnement des scripts, car elle élimine le besoin de reconstruire l'expression régulière si son modèle correspond à l'un des modèles existants. La taille par défaut du stockage est de 15. La méthode Regex::CacheSize() renvoie ou définit le nombre maximal d'entrées dans le cache statique actuel des expressions régulières conformes.
   
2. La deuxième caractéristique du travail avec les expressions régulières dans MQL4 découle directement de la première. Et cela réside dans le fait que le stockage ci-dessus doit être effacé. Pour ce faire, appelez la fonction statique Regex::ClearCache(). Il est recommandé de n'appeler cette fonction qu'une fois le travail avec les expressions régulières terminé, sinon il y a un risque de supprimer les pointeurs nécessaires.
3. Contrairement au .Net, le MQL4 n'implémente pas la boucle foreach, et donc la gestion de l'énumération sera différente. Exemple :

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

4. Comme le montre l'exemple ci-dessus, la syntaxe C# permet de mettre le symbole '@' devant les chaînes pour ignorer toutes les marques de formatage qu'elle contient. Dans MQL4, cette approche n'est pas fournie, donc tous les caractères de contrôle dans un modèle d'expression régulière doivent être explicitement définis.

Pour en savoir plus sur les RegularExpressions pour MQL4 et ses fonctionnalités, utilisez l'expert Tests.mqh fourni. Il implémente de nombreux exemples d'utilisation d'expressions régulières, qui couvrent toutes les fonctionnalités principales de la bibliothèque.