Result - type-safe error handling for MQL5 without exceptions - MetaTrader 5のためのライブラリ

目的

このインクルードファイルは、MQL5向けに「成功かエラーか」を示す戻り値型を提供します。これにより、関数はグローバル変数であるGetLastError()/ResetLastError() を通じてではなく、明示的に成功または失敗を報告できるようになります。グローバル変数による処理は、忘れられやすく、上書きされやすく、またアウトパラメータや「魔法のような」戻り値を強制してしまうという問題があります。

機能

関数は、値またはエラーのいずれかを保持する 1 つのオブジェクトを返します。呼び出し側は、値を使用する前にチェックを行う必要があります。

• ResultValue<T> — 値型（数値、構造体）用。
• Result<T> — ポインタで保持されるオブジェクト（クラス）に対する同様の契約。
• Error — 軽量な構造体（コード + 説明）。コードは EnumToString を通じて読みやすい名前にマッピングされます。
• MQLError — GetLastError / ResetLastError / SetUserError をラップしたシンプルなラッパー。
• マクロ — TRY 、 RETURN_ON_ERROR 、 PRINT_ON_ERROR 、 RETURN_SAME_ON_ERROR 、 RESULT_ON_ERROR — 定型コードを記述することなく、早期リターンを伝播させるためのものです。
• オプションのコールバック — Then 、 Match 、 MapError （ これらはトップレベル関数または静的関数を受け取ります。MQL5にはクロージャがありません）。

アクセサ： Value () 、 ValueOr (fallback) 、 CurrentError () 、 IsError () 。

使用方法

// ステージ関数（トップレベル — MQL5にはクロージャがない）
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); }

// パイプライン：読み込み → 検証 → 変換 → （エラーの注釈付け） → 処理
void RunPipeline()
{
   SymbolDouble("EURUSD", SYMBOL_BID)
      .Then(EnsurePositive)
      .Then(ToPips)
      .MapError(Describe)
      .Match(OnOk, OnFail);
}