Result - type-safe error handling for MQL5 without exceptions - bibliothèque pour MetaTrader 5

Objectif

Ce fichier d'inclusion fournit un type de retour « valeur ou erreur » pour MQL5, afin que les fonctions puissent signaler explicitement leur réussite ou leur échec, plutôt que de passer par l'état global GetLastError() / ResetLastError() — qui est facile à oublier, facile à écraser, et qui impose l'utilisation de paramètres de sortie et de valeurs de retour « magiques ».

Fonctionnement

Une fonction renvoie un objet contenant soit une valeur, soit une erreur ; l'appelant doit vérifier son contenu avant d'utiliser la valeur.

• ResultValue<T> — pour les types de valeur (nombres, structures).
• Result<T> — le même contrat pour les objets pointés (classes).
• Error — une structure légère (code + description) ; les codes sont mappés à des noms lisibles via EnumToString.
• MQLError — un simple wrapper autour de GetLastError / ResetLastError / SetUserError.
• Macros — TRY , RETURN_ON_ERROR , PRINT_ON_ERROR , RETURN_SAME_ON_ERROR , RESULT_ON_ERROR — pour la propagation des retours anticipés sans code standard.
• Callbacks optionnels — Then , Match , MapError ( ils acceptent des fonctions de niveau supérieur ou statiques ; MQL5 ne dispose pas de fermetures).

Accesseurs : Value (), ValueOr (fallback), CurrentError (), IsError ().

Utilisation

// Fonctions de scène (niveau supérieur — MQL5 ne prend pas en charge les fermetures)
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); }

// Le pipeline : lecture -> validation -> transformation -> (annotation des erreurs) -> traitement
void RunPipeline()
{
   SymbolDouble("EURUSD", SYMBOL_BID)
      .Then(EnsurePositive)
      .Then(ToPips)
      .MapError(Describe)
      .Match(OnOk, OnFail);
}