【MQL5】ArrayInitialize関数の使い方と自動売買実装コード

1. ArrayInitialize関数の概要と実務での活用法

MQL5におけるArrayInitializeは、数値型配列のすべての要素を指定した特定の値（初期値）で一括塗りつぶしするための関数です。

実務開発において、この関数は「計算結果の不整合（バグ）を防ぐための安全装置」として非常に重要です。MQL5で動的配列を宣言した直後やArrayResizeで拡張した直後は、メモリ内に以前使われていた「ゴミデータ（不定値）」が残っていることがあり、これを放置して計算に使うと、意図しないトレードシグナルが発生する原因になります。

特に、テクニカル指標の計算バッファや、一定期間の価格情報を格納するカスタム配列を扱う際、過去の古いデータをリセットして「空の状態（または計算に影響を与えない値）」にするために多用されます。

2. 構文と戻り値

ArrayInitialize関数の基本的な構文は以下の通りです。

int ArrayInitialize(
   double& array[], // 初期化対象の配列（参照渡し）
   double  value    // 代入する値
);

パラメーター

• array[]: 初期化したい配列を指定します。数値型の配列（double, float, int, longなど）である必要があります。
• value: 配列の全要素に代入したい値を指定します。

戻り値

• 正常に処理された場合は、初期化された配列の要素数を返します。
• 失敗した場合は -1 を返します。

3. 具体的な使い方・実践サンプルコード

以下は、EA（エキスパートアドバイザー）の初期化時や、新しいバーが生成された際に配列をリセットする実用的なコード例です。

//+------------------------------------------------------------------+
//| 配列初期化のデモEA                                                 |
//+------------------------------------------------------------------+
#property strict

// グローバル変数
double myDataBuffer[]; // 計算用の動的配列

//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
{
    // 1. 配列のサイズを100に設定
    if(ArrayResize(myDataBuffer, 100) < 0)
    {
        Print("配列のサイズ設定に失敗しました");
        return(INIT_FAILED);
    }

    // 2. 配列をすべて「0.0」で初期化
    // これにより、メモリ内のゴミデータがクリアされる
    int initializedElements = ArrayInitialize(myDataBuffer, 0.0);

    if(initializedElements > 0)
    {
        Print("配列を初期化しました。要素数: ", initializedElements);
    }

    return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| Expert tick function                                             |
//+------------------------------------------------------------------+
void OnTick()
{
    // 例：特定の条件で配列を空の値（EMPTY_VALUE）でリセットする
    // EMPTY_VALUEはチャート上に描画したくない時などに使われる定数
    if(TimeCurrent() % 3600 == 0) // 1時間ごとにリセット
    {
        ArrayInitialize(myDataBuffer, EMPTY_VALUE);
        Print("バッファをEMPTY_VALUEでリセットしました。");
    }
}

4. 使用上の注意点とよくあるエラー

動的配列は「サイズ決定後」に実行すること

もっとも多いミスは、ArrayResizeでサイズを確保する前にArrayInitializeを呼び出してしまうことです。要素数が0の配列に対して初期化を行っても、何も起こりません（戻り値は0になります）。

文字列配列には使用不可

ArrayInitializeは数値型専用です。string型の配列を初期化しようとするとコンパイルエラーになります。文字列配列をクリアしたい場合は、ループ文で個別に空文字（””）を代入する必要があります。

多次元配列での挙動

MQL5のArrayInitializeは多次元配列も処理できますが、すべての要素がフラットに指定した値で埋められます。特定の次元だけを初期化するといった器用なことはできないため注意してください。

初期化値の選択

計算用バッファであれば 0.0、価格データや指標バッファであれば EMPTY_VALUE や 0 など、その後のロジックで「データが存在しないこと」を判定しやすい値を選ぶのがクオンツ流の作法です。

5. 【重要】自動売買における約定スピードと環境の罠

アルゴリズム取引において、コードの最適化と同じくらい、あるいはそれ以上に重要なのが「物理的な実行環境」です。自宅のPCや一般的な光回線でEAを稼働させる場合、ブローカーのサーバーとの間に数十ミリ秒（ms）から数百ミリ秒のネットワーク遅延（レイテンシ）が発生します。この遅延は、急変時のスリッページを引き起こし、バックテストでは利益が出ていても実運用では損失が積み重なる「負の期待値」の正体となります。

プロのクオンツエンジニアが極限まで約定スピードを求めるのは、コンマ数秒の遅れが利益を削り取ることを知っているからです。このレイテンシを最小化し、機関投資家に近い環境を構築するには、ブローカーの取引サーバーと物理的に近いデータセンターに設置された「専用のVPS（仮想専用サーバー）」の利用が不可欠です。24時間365日の安定稼働はもちろん、ネットワーク遅延を1ms単位で削ぎ落とすことが、自動売買を「ギャンブル」から「投資」へと昇華させるための絶対条件となります。