MQL4(MT4) SetIndexEmptyValueの使い方

SetIndexEmptyValue関数は、MetaTrader 4 (MT4) の MQL4 プログラミング言語で使用される関数です。この関数は、カスタムインディケーターの特定のバッファに対して「空の値」を設定するために使われます。インディケーターの計算で特定の条件下で値が定義されない場合に、そのバッファの位置に描画されるべきものがないことを示すために使用されます。つまり、この関数によって設定された値は、チャート上でそのポイントが空白として表示されることを意味します。

関数の基本形式

void SetIndexEmptyValue(int index, double value);

• index: 空の値を設定したいインディケーターバッファのインデックス（0から始まる）。
• value: 空として扱う値。この値がバッファに設定された場合、インディケーターはそのポイントを描画しません。

使用例

以下の例では、カスタムインディケーターでバッファ0の空の値としてEMPTY_VALUE（通常は非常に大きな値）を設定しています。これにより、条件に基づいて計算された値がEMPTY_VALUEと等しい場合、そのデータポイントはチャート上に描画されません。

int OnInit() {
    // バッファ0の空の値を設定
    SetIndexEmptyValue(0, EMPTY_VALUE);

    // インディケーターのその他の初期化処理...

    return(INIT_SUCCEEDED);
}

注意点

• EMPTY_VALUEの選択: EMPTY_VALUEは、他の有効なインディケーター値と区別できるように選択する必要があります。MQL4ではEMPTY_VALUEは通常1.0e+100と定義されており、実際のインディケーター値としてはあり得ない非常に大きな数値です。
• パフォーマンスへの影響: 空の値を適切に設定することで、不要な計算を避け、インディケーターのパフォーマンスを向上させることができます。特に計算が重いインディケーターで有用です。
• 可視性と解釈: 空の値を使用することでチャートの可読性を高めることができますが、ユーザーがなぜ特定のポイントでインディケーターが表示されないのかを理解できるように、ドキュメントや説明が適切に提供されていることが重要です。
• 初期化関数での使用: SetIndexEmptyValueは、インディケーターの初期化関数OnInit内で使用するのが一般的ですが、条件に基づいて動的に空の値を変更することも可能です。

SetIndexEmptyValue関数を使用することで、インディケーターの表示をよりコントロールし、チャートの解釈を助けることができます。適切なEMPTY_VALUEの選択と使用により、ユーザーにとってより有益なインディケーターを作成することが可能になります。