sToken - MetaTrader 5 için kütüphane

Dize olarak verilen matematiksel ve mantıksal ifadeleri çözmek için bir sınıf içeren betik.

Betik, cTokenBase ve cTokenBase sınıfının bir üyesi olan cToken olmak üzere iki sınıf içerir. Sınıflar ayrı bir dosyaya taşınmamıştır, çünkü pratik uygulamalar için cTokenBase sınıfında bazı değişiklikler yapılması gerekmektedir (buna aşağıda değinilecektir).

MQL5 dilindeki tüm matematiksel fonksiyonlar desteklenmektedir: abs, arccos, arcsin, arctan, ceil, cos, exp, floor, log, log10, max, min, mod, pow, rand, round, sin, sqrt, tan.

Aritmetik ve mantıksal işlemler desteklenmektedir: ;/, %, *, +, -, >, <, >=, <=, ==, !=, &&, ||.

İfadenin argümanları, ondalık ayırıcı (nokta) içeren sayılar, kullanıcı değişkenleri ve kullanıcı dizileri olabilir. Kullanıcı değişkenleri ve dizileri kullanılırken, bu değişkenlerin ve dizilerin değerlerini alan fonksiyonların eklenmesi gerekir.

Kullanıcı değişkenlerinin ve dizilerinin değerlerini alma işlevleri cTokenBase sınıfına eklenir; aslında bu amaçla iki sınıfa ayrılmıştır: cToken sınıfı herhangi bir değişiklik yapılmadan kullanılırken, cTokenBase sınıfında değişkenlerin ve dizilerin değerlerini alma işlevleri bulunur.

Değişken ve dizilerin adları harflerden oluşur (büyük/küçük harf fark etmez; aynı şekilde ifadenin tamamının büyük/küçük harfleri de fark etmez), dizi elemanları köşeli parantez içindeki sayılarla tanımlanır; örneğin: e[0], e[1], f[0], f[1].

Örnek:

cTokenBase sınıfını düzenleme sırası

1. Değişken veya dizi adını kaydedin. Kayıt işlemi UsersVariables() işlevinde gerçekleştirilir. Bu işlevde UserVariables ve UserArrays değişkenlerine değerler atanır; ";" ayırıcısıyla ayrılmış değişken listeleri şeklinde dize değerleri atanır.

      void UsersVariables()
      {
         UserVariables="a;b;c;d"; // kullanıcı değişkenleri listesi
         UserArrays="e;f";       // kullanıcı dizileri listesi  
      } 

2. UserFunc(string FuncName) işlevine, ilgili işlev argümanıyla birlikte belirli bir işlevin çağrısını ekleyin.

      string UserFunc(string FuncName)
      {
         if(FuncName=="a")return(a()); 
         if(FuncName=="b")return(b());
         if(FuncName=="c")return(c());
         if(FuncName=="d")return(d());
         Alert("Değişken için işlev"+FuncName+"belirlenmemiş");
         return("0");
      }

3. Her bir kullanıcı değişkeni için fonksiyon yazınız:

      string a()
      {
         return("1");
      }
      string b()
      {
         return("2");
      }
      string c()
      {
         return("3");
      }
      string d()
      {
         return("4");
      } 

4. UserArray(string ArrName, int aIndex) işlevine, işlevin ilk argümanı (ArrName değişkeni) ile belirli bir işlevin çağrılmasını ekleyin.

aIndex değişkeni, kullanıcı dizisinin elemanının indeksini belirleyecektir.

      string UserArray(string ArrName,int aIndex)
       {
         if(ArrName=="e")return(e(aIndex));
         if(ArrName=="f")return(f(aIndex));
         Alert("Dizi işlevi"+ArrName+"belirlenmemiş");
         return("0");
      }

5. Her bir kullanıcı dizisi için fonksiyonlar yazın:

      string e(int Index)
      {
         string v[]={"1","2","3","4","5","6","7","8","9"};
         return(v[Index]);
      }
      string f(int Index)
      {
         string v[]={"10","20","30","40","50","60","70","80","90"};
         return(v[Index]);
      }

Sınıfın kullanım sırası

1. Kullanıcının ifadeyi gireceği bir dış değişken tanımlayın.

input string Expression="ifadeyi girin";

2. Modülün genel bölümünde, sınıfa işaret eden bir değişken tanımlayın:

cToken token;

3. Expression değişkeninde belirtilen ifade ile sınıfın başlatılmasını gerçekleştirin.

   token.Init(Expression);

4. Gerektiğinde SolveExpression() yöntemini çağırın.

double Value=token.SolveExpression();

Sınıf, birden fazla ifadenin çözülmesi için kullanılabilir; her biri için ayrı bir sınıf işaretçisi tanımlanır.

cToken token1;
cToken token2;
cToken token3;
cToken token4;

Bu durumda, tüm sınıf örnekleri cTokenBase sınıfındaki aynı kullanıcı değişkenlerini ve dizileri kullanacaktır.

Sınıf, başka işlevlerin kullanılması için geliştirilebilir.

cToken sınıfına yeni işlevler ekleme

1. Yeni bir fonksiyonu kaydedin. Kayıt işlemi, Init() fonksiyonunda "as" değişkeninde gerçekleştirilir (kullanıcı değişkenleri ve dizilerin kaydedilmesine benzer şekilde).
2. SolveFunc(string Func, string &aRes[]) işlevine yeni işlevin hesaplama kodunu ekleyin. İşlevin hesaplanması için gerekli argümanlar aRes[] dizisinde bulunur. İşlevler istediği sayıda argümana sahip olabilir.