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

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

MQL5のArrayInsert関数は、ある配列の指定した位置に、別の配列の要素を「割り込ませる」形で挿入するための便利な関数です。

実務レベルの開発、特に動的なデータ管理が必要なEA（エキスパートアドバイザー）開発において、この関数は非常に重宝します。例えば、「過去10回分のエントリー価格リストの途中に新しいデータを差し込む」といった処理や、「特定の条件を満たした複数のインジケーター値を一つの配列に統合する」といった場面で活躍します。

初心者が陥りやすい罠として、単に配列の末尾にデータを追加するArrayResizeとArrayCopyの組み合わせで代用しようとし、コードが複雑化・バグ化してしまうケースがあります。ArrayInsertを正しく使いこなすことで、メモリ管理をスマートに行い、可読性の高いコードを書くことが可能になります。

2. 構文と戻り値

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

bool ArrayInsert(
   void&  dest_array[],      // 挿入先の配列（ターゲット）
   const void& src_array[],  // 挿入するデータの元の配列（ソース）
   uint   dest_index,        // 挿入を開始するターゲット配列のインデックス
   uint   src_index=0,       // ソース配列のどの位置からコピーするか（デフォルトは0）
   uint   count=WHOLE_ARRAY  // コピーする要素数（デフォルトは全要素）
);

パラメーター解説

• dest_array[]: データを挿入したい「受け側」の配列です。
• src_array[]: 挿入したいデータが入っている「送り側」の配列です。
• dest_index: 挿入先の配列の何番目にデータを入れるかを指定します。
• src_index: ソース配列の何番目の要素から使い始めるかを指定します。
• count: ソース配列から何個の要素を抜き出すかを指定します。

戻り値

• 成功した場合は true、失敗した場合は false を返します。失敗の原因（エラーコード）は GetLastError() 関数で確認できます。

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

以下は、既存の価格リスト（配列）の特定のインデックスに、新しいデータを挿入する実践的なサンプルコードです。

//+------------------------------------------------------------------+
//| Script program start function                                    |
//+------------------------------------------------------------------+
void OnStart()
{
    // 1. 挿入先の配列を準備（あらかじめデータが入っている想定）
    double targetArray[];
    ArrayResize(targetArray, 5);
    targetArray[0] = 1.1010;
    targetArray[1] = 1.1020;
    targetArray[2] = 1.1030;
    targetArray[3] = 1.1040;
    targetArray[4] = 1.1050;

    // 2. 挿入したいデータの配列を準備
    double newData[];
    ArrayResize(newData, 2);
    newData[0] = 9.9999; // 割り込ませたい値1
    newData[1] = 8.8888; // 割り込ませたい値2

    // 3. ArrayInsertを使って、targetArrayのインデックス「2」の位置に挿入
    // 結果として、もともとの index 2 以降のデータは後ろに押し出されます
    if(ArrayInsert(targetArray, newData, 2, 0, WHOLE_ARRAY))
    {
        Print("挿入成功！");

        // 配列の中身を確認
        for(int i=0; i<ArraySize(targetArray); i++)
        {
            PrintFormat("Index[%d] : %.5f", i, targetArray[i]);
        }
    }
    else
    {
        Print("挿入失敗。エラーコード:", GetLastError());
    }
}

このコードを実行すると、元の配列のインデックス2に新しい2つの要素が挿入され、配列全体のサイズが自動的に拡張されます。

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

開発時に注意すべき点は主に3つあります。

1. 動的配列であること:
   dest_array（挿入先）は必ず動的配列（サイズ指定なしで宣言した配列）である必要があります。静的配列（double arr[10] など）を指定すると、実行時にエラーとなります。

2. インデックスの範囲外指定:
   dest_index に、現在の配列サイズを超える数値を指定することはできません。例えば、要素数が5つの配列に対してインデックス10を指定するとエラーになります。末尾に追加したい場合は、dest_index に ArraySize(targetArray) を指定します。

3. 時系列配列（Series）の扱い:
   ArraySetAsSeries で並び順を反転させている配列に対して使用する場合、インデックスの数え方に注意が必要です。意図しない位置にデータが挿入される原因になるため、複雑な処理の前には一旦 Series 設定を解除するか、通常の配列として処理することをお勧めします。

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

アルゴリズムトレードにおいて、ArrayInsert を使ったデータ処理をどれだけ高速化しても、避けることができない物理的な壁が「ネットワーク遅延（レイテンシ）」です。自宅のPC環境でEAを稼働させる場合、プロバイダー経由の通信は、証券会社のサーバーに到達するまでに数十から数百ミリ秒の時間を要します。このわずかな遅延が、急変時のスリッページを引き起こし、理論上の利益を削り取る致命的な損失要因となります。

特に、1分足や秒単位のロジックを組み込むエンジニアにとって、約定スピードの追求はアルゴリズムの改善以上に重要です。極限まで有利な価格で約定させるには、証券会社のデータセンターに近い場所に位置する「専用のVPS（仮想専用サーバー）」の利用が不可欠です。24時間安定した稼働環境と、1ミリ秒を争う低遅延なネットワーク環境を整えることは、プロのクオンツエンジニアとして勝つための最低限のインフラ投資と言えるでしょう。