Result - type-safe error handling for MQL5 without exceptions - Bibliothek für den MetaTrader 5

Zweck

Diese Include-Datei stellt einen Rückgabetyp vom Typ „Wert oder Fehler“ für MQL5 bereit, sodass Funktionen Erfolg oder Misserfolg explizit melden können, anstatt dies über den globalen Status von GetLastError() / ResetLastError() zu tun – was leicht zu vergessen und leicht zu überschreiben ist und Out-Parameter sowie „magische“ Rückgabewerte erzwingt.

Funktionsweise

Eine Funktion gibt ein Objekt zurück, das entweder einen Wert oder einen Fehler enthält; der Aufrufer muss dies vor der Verwendung des Werts überprüfen.

• ResultValue<T> – für Werttypen (Zahlen, Strukturen).
• Result<T> – derselbe Vertrag für Objekte, die über einen Zeiger gehalten werden (Klassen).
• Error – eine schlanke Struktur (Code + Beschreibung); Codes werden über EnumToString lesbaren Namen zugeordnet.
• MQLError — ein schlanker Wrapper um GetLastError / ResetLastError / SetUserError.
• Makros — TRY , RETURN_ON_ERROR , PRINT_ON_ERROR , RETURN_SAME_ON_ERROR , RESULT_ON_ERROR — für die Weitergabe von vorzeitigen Rückgaben ohne Boilerplate-Code.
• Optionale Callbacks — Then , Match , MapError ( sie akzeptieren Funktionen auf oberster Ebene oder statische Funktionen; MQL5 kennt keine Closures).

Zugriffsfunktionen: Value (), ValueOr (Fallback), CurrentError (), IsError ().

Verwendung

// Stage-Funktionen (auf oberster Ebene – MQL5 kennt keine Closures)
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); }

// Die Pipeline: Einlesen -> Validieren -> Transformieren -> (Fehler kennzeichnen) -> Bearbeiten
void RunPipeline()
{
   SymbolDouble("EURUSD", SYMBOL_BID)
      .Then(EnsurePositive)
      .Then(ToPips)
      .MapError(Describe)
      .Match(OnOk, OnFail);
}