Result - type-safe error handling for MQL5 without exceptions - libreria per MetaTrader 5

Scopo

Questo file di inclusione fornisce un tipo di ritorno "valore o errore" per MQL5, in modo che le funzioni possano segnalare esplicitamente il successo o il fallimento invece di ricorrere allo stato globale di GetLastError() / ResetLastError() — che è facile da dimenticare, facile da sovrascrivere e impone l'uso di parametri di uscita e valori di ritorno "magici".

Cosa fa

Una funzione restituisce un oggetto che contiene un valore o un errore; il chiamante deve verificare il contenuto prima di utilizzare il valore.

• ResultValue<T> — per i tipi di valore (numeri, strutture).
• Result<T> — lo stesso contratto per gli oggetti gestiti tramite puntatore (classi).
• Error — una struttura leggera (codice + descrizione); i codici vengono mappati su nomi leggibili tramite EnumToString.
• MQLError — un wrapper leggero su GetLastError / ResetLastError / SetUserError.
• Macro — TRY , RETURN_ON_ERROR , PRINT_ON_ERROR , RETURN_SAME_ON_ERROR , RESULT_ON_ERROR — per la propagazione del ritorno anticipato senza codice boilerplate.
• Callback opzionali — Then , Match , MapError ( accettano funzioni di primo livello o statiche; MQL5 non supporta le chiusure).

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

Utilizzo

// Funzioni di stage (di primo livello — MQL5 non prevede chiusure)
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); }

// Il flusso di lavoro: lettura -> convalida -> trasformazione -> (annotazione dell'errore) -> gestione
void RunPipeline()
{
   SymbolDouble("EURUSD", SYMBOL_BID)
      .Then(EnsurePositive)
      .Then(ToPips)
      .MapError(Describe)
      .Match(OnOk, OnFail);
}