Result - type-safe error handling for MQL5 without exceptions - MetaTrader 5용 라이브러리

목적

이 포함 파일은 MQL5용 '값 또는 오류' 반환 유형을 제공하므로, 함수는 전역 변수인 GetLastError() / ResetLastError() 상태를 통해 처리하는 대신 성공 또는 실패를 명시적으로 보고할 수 있습니다. 전역 변수 방식은 잊어버리기 쉽고, 덮어쓰기 쉬우며, 아웃 매개변수와 "마법 같은" 반환 값을 강제로 사용해야 하는 단점이 있습니다.

기능

함수는 값을 포함하거나 오류를 포함하는 하나의 객체를 반환하며, 호출자는 값을 사용하기 전에 이를 확인해야 합니다.

• 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);
}