Result - type-safe error handling for MQL5 without exceptions - MetaTrader 5 için kütüphane

Amaç

Bu dahil dosyası, MQL5 için bir değer veya hata dönüş türü sağlar; böylece işlevler, unutulması ve üzerine yazılması kolay olan ve çıkış parametrelerini ve "sihirli" dönüş değerlerini zorunlu kılan küresel GetLastError() / ResetLastError() durumu yerine, başarıyı veya başarısızlığı açıkça bildirebilir.

Ne Yapar

Bir fonksiyon, ya bir değer ya da bir Hata içeren tek bir nesne döndürür; çağıran taraf, değeri kullanmadan önce bunu kontrol etmelidir.

• ResultValue<T> — değer türleri (sayılar, yapılar) için.
• Result<T> — işaretçi ile tutulan nesneler (sınıflar) için aynı sözleşme.
• Error — hafif bir yapı (kod + açıklama); kodlar, EnumToString aracılığıyla okunabilir adlara eşlenir.
• MQLError — GetLastError / ResetLastError / SetUserError üzerinde ince bir sarmalayıcıdır.
• Makrolar — TRY , RETURN_ON_ERROR , PRINT_ON_ERROR , RETURN_SAME_ON_ERROR , RESULT_ON_ERROR — tekrarlanan kod yazmaya gerek kalmadan erken dönüşün yayılması için.
• İsteğe bağlı geri çağırmalar — Then , Match , MapError ( en üst düzey veya statik işlevleri kabul ederler; MQL5'te kapanışlar yoktur).

Erişim işlevleri: Value () , ValueOr (fallback) , CurrentError () , IsError () .

Kullanım

// Aşama işlevleri (üst düzey — MQL5’te kapanışlar yoktur)
ResultValue<double> EnsurePositive(const double &value)
{
   if (value <= 0.0)
   {
      return ResultValue<double>::Fail("price must be positive");
   }
   return ResultValue<double>::Ok(value);
}

ResultValue<double> ToPips(const double &price)
{
   return ResultValue<double>::Ok(price / _Point);
}

Error Describe(const Error &error)
{
   return Error::Create(error.code, "pipeline failed: " + error.description);
}

void OnOk(const double &value)  { PrintFormat("[pipeline] result = %.1f pips", value); }
void OnFail(const Error &error) { PrintFormat("[pipeline] %s", error.description); }

// İş akışı: okuma -> doğrulama -> dönüştürme -> (hata notu ekleme) -> işleme
void RunPipeline()
{
   SymbolDouble("EURUSD", SYMBOL_BID)
      .Then(EnsurePositive)
      .Then(ToPips)
      .MapError(Describe)
      .Match(OnOk, OnFail);
}