Result - type-safe error handling for MQL5 without exceptions - librería para MetaTrader 5

Objetivo

Este archivo de inclusión proporciona un tipo de retorno de valor o error para MQL5, de modo que las funciones puedan informar explícitamente del éxito o el fracaso, en lugar de hacerlo a través del estado global de GetLastError() / ResetLastError() —que es fácil de olvidar, fácil de sobrescribir y obliga a utilizar parámetros de salida y valores de retorno «mágicos».

Qué hace

Una función devuelve un objeto que contiene un valor o un error; el llamante debe comprobarlo antes de utilizar el valor.

• ResultValue<T> — para tipos de valor (números, estructuras).
• Result<T> — el mismo contrato para objetos almacenados mediante puntero (clases).
• Error — una estructura ligera (código + descripción); los códigos se asocian a nombres legibles mediante EnumToString.
• MQLError — una envoltura ligera sobre GetLastError / ResetLastError / SetUserError.
• Macros — TRY , RETURN_ON_ERROR , PRINT_ON_ERROR , RETURN_SAME_ON_ERROR , RESULT_ON_ERROR — para la propagación de retornos anticipados sin código repetitivo.
• Callbacks opcionales — Then , Match , MapError ( aceptan funciones de nivel superior o estáticas; MQL5 no admite clausuras).

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

Uso

// Funciones de etapa (nivel superior — MQL5 no admite clausuras)
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); }

// El proceso: leer -> validar -> transformar -> (anotar el error) -> gestionar
void RunPipeline()
{
   SymbolDouble("EURUSD", SYMBOL_BID)
      .Then(EnsurePositive)
      .Then(ToPips)
      .MapError(Describe)
      .Match(OnOk, OnFail);
}