【検証#09】iCustomの引数省略は超危険！¶

double iCustom(
   string       symbol,           // 通貨ペア
   int          timeframe,        // 時間足
   string       name,             // インジケータ名
   ...                            // インジケータのパラメータ群
   int          mode,             // バッファ番号
   int          shift             // シフト
);

// 3つのパラメータを持つインジケータ
extern int    Period1 = 14;
extern int    Period2 = 26;
extern double Factor  = 1.5;

// ★危険★ 引数を一部省略
double value = iCustom(NULL, 0, "MyIndicator",
                       14,      // Period1のみ指定
                       // Period2とFactorを省略！
                       0, 0);   // mode, shift

int iCustom(
   string           symbol,        // 通貨ペア
   ENUM_TIMEFRAMES  period,        // 時間足
   string           name,          // インジケータ名
   ...                             // パラメータ群（可変長）
);

int handle = iCustom(_Symbol, PERIOD_CURRENT, "MyIndicator", 14, 26, 1.5);
double buffer[];
CopyBuffer(handle, 0, 0, 1, buffer);  // バッファ0のshift 0を取得

//+------------------------------------------------------------------+
//|                                          iCustom_Trap.mq5         |
//| 「とあるMetaTraderの備忘秘録」様の記事を検証                        |
//| https://fai-fx.hatenadiary.org/entry/20100413/1271093279          |
//+------------------------------------------------------------------+
#property copyright "FXおもしろラボ"
#property link      "https://fx-omoshiro-lab.com/"
#property version   "1.00"
#property script_show_inputs

void OnStart()
{
    Print("=== iCustom 引数問題の解説 ===");
    Print("");
    Print("このスクリプトは概念説明用です。");
    Print("実際のインジケータは含まれていません。");
    Print("");

    // 正しい呼び出し例（RSI）
    Print("--- 正しい呼び出し例 ---");
    int rsiHandle = iRSI(_Symbol, PERIOD_CURRENT, 14, PRICE_CLOSE);

    if(rsiHandle != INVALID_HANDLE)
    {
        double rsiBuffer[];
        ArraySetAsSeries(rsiBuffer, true);
        CopyBuffer(rsiHandle, 0, 0, 1, rsiBuffer);
        PrintFormat("RSI(14) = %.2f", rsiBuffer[0]);
        IndicatorRelease(rsiHandle);
    }

    Print("");
    Print("--- iCustom使用時の注意点 ---");
    Print("1. インジケータのパラメータ数を正確に把握する");
    Print("2. すべてのパラメータを明示的に指定する");
    Print("3. パラメータの型（int/double/string）を正しく指定する");
    Print("4. デフォルト値であっても省略しない");

    Print("");
    Print("--- 危険なパターン例 ---");
    Print("// インジケータが3つのパラメータを要求するのに2つしか渡さない");
    Print("// int h = iCustom(_Symbol, PERIOD_H1, \"SomeIndicator\", 14, 26);");
    Print("// ↑ 3番目のパラメータは不定値になる！");

    Print("");
    Print("--- 安全なパターン ---");
    Print("// すべてのパラメータを明示的に指定");
    Print("// int h = iCustom(_Symbol, PERIOD_H1, \"SomeIndicator\", 14, 26, 1.5);");

    Print("");
    Print("=== 解説完了 ===");
}