Düzenli İfadelerle Çalışmak İçin MQL5'te RegularExpressions - MetaTrader 5 için kütüphane

Gerçek yazar

Microsoft Corporation. Kaynak kodu .Net Framework 4.6.1'den alınmıştır. 

.Net Framework 4.6.1'ten RegularExpressions kütüphanesinin port edilmesi aşağıda gösterilmiştir.

Kütüphaneyle çalışmak için, \MQL5\Include\RegularExpressions\ klasöründeki Regex.mqh dosyasını kodunuza eklemeniz gerekir.

Kütüphaneyle birlikte, aynı zamanda test senaryoları olarak da hizmet eden birkaç açıklayıcı örnek de sağlanmıştır. Tüm örnekler Microsoft Corporation'ın resmi web sitesinden alınmıştır ve C#'daki düzenli ifadelerden temel farklarını ve MQL5'teki kullanım özelliklerini açıkça gösterirler.

RegularExpressions'ın MQL5'e port edilen kütüphane paketleri hakkında daha detaylı bilgiler aşağıdadır:

RegexOptions.mqh dosyasındaki düzenli ifade parametreleri:

MQL5'e port edilmiş RegularExpressions ile çalışmanın özellikleri:

1. .Net versiyonunda olduğu gibi, bu kütüphane düzenli ifadelerin saklanmasını (statik önbellek) uygular. Örtülü olarak oluşturulan tüm düzenli ifadeler (Regex sınıfının örnekleri) bu depoya yazılır. Bu yaklaşım, kalıbı mevcut olanlardan herhangi biriyle eşleşirse düzenli ifadeyi yeniden oluşturma ihtiyacını ortadan kaldırdığı için komut dosyalarının çalışmasını hızlandırır. Depolamanın varsayılan boyutu 15'tir. Regex::CacheSize() metodu, uyumlu düzenli ifadelerin geçerli statik önbelleğindeki maksimum girdi sayısını geri döndürür veya ayarlar.
   
2. MQL5'te düzenli ifadelerle çalışmanın ikinci özelliği, doğrudan ilkinden sonra gelir. Ve yukarıdaki depolamanın temizlenmesi gerektiği gerçeğine dayanır. Bunu yapmak için, Regex::ClearCache() statik fonksiyonunun çağrılması gerekir. Bu fonksiyonun yalnızca düzenli ifadelerle çalışma tamamlandıktan sonra çağrılması önerilir, aksi takdirde gerekli işaretçileri silme riski vardır.
3. .Net'in aksine, MQL5 foreach döngüsünü uygulamaz ve bu nedenle numaralandırma yönetimi farklı olacaktır. Örnek:

   //--- C#'ta kod
   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) 
     {
      //--- yönet
     }
   
   //--- MQL5'te kod
   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();
      //--- yönet
     }
   delete rx;
   delete matches;
   delete en;
   Regex::ClearCache();
   

4. Yukarıdaki örnekten de görülebileceği gibi, C# söz dizimi, içindeki tüm biçimlendirme işaretlerini yok saymak için '@' karakterini dizgelerin önüne koymaya izin verir. MQL5'te bu yaklaşım sağlanmamıştır, bu nedenle düzenli ifade kalıbındaki tüm kontrol karakterleri açıkça tanımlanmalıdır.

MQL5'e port edilmiş RegularExpressions ile çalışma örneği:

Düzenli ifadelerin nasıl çalıştığına bir örnek olarak, terminalden html dosyası biçiminde indirilen bir işlem geçmişini ayrıştırmak adına düzenli ifadelerin kullanımlarını ele alalım.

Bunu yapmak için, sandboxtaki dosyanın adı olacak olan string türünde tek bir girdi parametresiyle bir Uzman Danışman oluşturalım:

Bu belge iki ana tablo içerir: "Emirler" ve "İşlemler". 

Dosyayı ayrıştırmak için bir düzenli ifade oluşturalım:

Regex *rgx=new Regex("(>)([^<>]*)(<)");

Şu düzenli ifadeyi ele alalım:

Ardından, dosyayı satır satır okuruz ve bu düzenli ifadeye karşılık gelen tüm eşleşmeleri alırız:

string str=FileReadString(m_handel);
MatchCollection *matches=rgx.Matches(str);

"Emirler" ve "İşlemler" tabloları için girdiler (veri grupları) olan html dosyasının dizgeleri, bu tür eşleşmelerin çoğuna, yani sırasıyla 23 ve 27 eşleşmeye sahip olacaktır. Bu nedenle, geriye kalan tek şey bu dizgelerden gerekli tüm bilgileri çıkarmaktır.

"Emirler" tablosu için:

if(matches.Count()==23)
  {
   string in[11];
   for(int i=0,j=1; i<11; i++,j+=2)
     {
      in[i]=StringSubstr(matches[j].Value(),1,StringLen(matches[j].Value())-2);
     }
   m_list1.Add(new OrderRecord(in));
  }

Eşleşme sayısının 23 olduğu ve böylece yönetilen girdinin "Emirler" tablosundan olduğu doğrulandı. Girdimizin başlangıç temsili olarak bir dizge dizisi oluşturalım. Tüm tek sayılı eşleşmeler üzerinde yineleme oluşturalım, matches[j][.Value() metodunu kullanarak bu eşleşmelerin değerlerini alalım ve '>' ve '<' karakterlerine karşılık gelen her eşleşmenin ilk ve son karakterlerini kırpalım. Her biçimlendirilmiş eşleşme, önceden bildirilen in dizisine yazılır. Ardından, "Emirler" tablosunun tek bir girdisini temsil eden OrderRecord(in) sınıfının yeni bir örneğini oluşturalım ve onu m_list1 listesine ekleyelim. Bu liste "Emirler" tablosunu yorumlayacak.

"İşlemler" tablosu da benzer şekilde işlenir:

if(matches.Count()==27)
  {
   string in[13];
   for(int i=0,j=1; i<13; i++,j+=2)
     {
      in[i]=StringSubstr(matches[j].Value(),1,StringLen(matches[j].Value())-2);
     }
   m_list2.Add(new DealRecord(in));
  }

Burada m_list2, DealRecord sınıfına yönelik işaretçilerin listesidir. "İşlemler" tablosunu temsil eder.

Bu listelerin her ikisi de TradeHistory sınıfının üyeleridir. Bu sınıf, tüm kaynak html dosyasının temsilidir. Ayrıca, FindAllOrders(const int columnIndex,const T value) ve FindAllDeals(const int columnIndex,const T value) metotlarını kullanarak "Emirler" ve "İşlemler" tablolarına basit filtreler uygulanmasına olanak tanır.

Bu özellikleri göstermek için Uzman Danışmanda basit bir grafik arayüzü oluşturalım:

Bu formla çalışırken, istediğimiz tabloyu seçiyoruz ve tabloyu filtrelemek için de sütunu ve değerini seçiyoruz. Find düğmesine basıyoruz ve filtrelenmiş tablo, bazı istatistiklerle birlikte aşağıda görüntülenecektir. Save düğmesi, o anda görüntülenen tabloyu bir csv dosyasına kaydeder. Kaydedilen dosya da sandboxta bulunur ve Result.csv olarak adlandırılır.

MQL5'e port edilmiş RegularExpressions ve özellikleri hakkında daha fazla bilgi edinmek için sağlanan Tests.mqh Uzman Danışmanını kullanın. Kütüphanenin tüm ana işlevselliklerini kapsayan çok sayıda düzenli ifade kullanımına ilişkin örnekler yer alır.