MQL4(MT4) OrdersTotalの使い方

OrdersTotal関数は、MetaTrader 4 (MT4) プラットフォームで現在保持している注文の合計数を返すMQL4言語の関数です。この関数は、特に複数の注文を管理する必要があるExpert Advisor (EA) を開発する際に便利です。

OrdersTotal関数の使用例

OrdersTotal関数は非常にシンプルで、引数を取らずに現在の注文総数を整数で返します。

注文数のチェックと基本情報の表示

void OnStart()
{
    // 現在の注文総数を取得
    int totalOrders = OrdersTotal();

    // 注文総数を表示
    Print("現在の注文総数: ", totalOrders);

    // 各注文の基本情報を表示
    for(int i = 0; i < totalOrders; i++)
    {
        if(OrderSelect(i, SELECT_BY_POS)) // 注文を選択
        {
            // 注文情報の表示
            Print("注文 #", OrderTicket(), ": ", OrderType(), " ", NormalizeDouble(OrderLots(), 2), " ロット ", OrderSymbol(), " at ", NormalizeDouble(OrderOpenPrice(), 5));
        }
    }
}

この例では、OrdersTotalを使用して現在の注文総数を取得し、その後でOrderSelect関数を使って各注文にアクセスし、注文の基本情報を表示しています。

注意点

• ループ内での注文選択: OrdersTotalで取得した注文数に基づいてループを行い、その中でOrderSelectを使用して各注文にアクセスする場合、SELECT_BY_POSモードを使用して注文を選択します。これにより、ループのインデックスをそのまま注文の位置として使用できます。
• ループの方向: 注文をループ処理する際には、新しい注文から古い注文へと逆順で処理することが一般的です。これは、注文が閉じられたり削除されたりすると、注文リストのインデックスが変わる可能性があるためです。ただし、上記の例ではこのような操作を行っていないため、順方向のループを使用しています。
• エラーハンドリング: OrderSelect関数は、指定された注文が選択できなかった場合にfalseを返します。選択した注文にアクセスする前に、この関数の戻り値を常にチェックすることが重要です。
• マルチスレッド環境との互換性: MT4はシングルスレッドアプリケーションですが、注文処理中に外部からの注文更新（例えば、他のEAや手動操作による）が発生する可能性があります。そのため、注文の総数や特定の注文の状態を取得する際は、常に最新の情報を参照していることを確認する必要があります。

OrdersTotal関数とこれに関連する注文操作関数を理解し、適切に使用することで、EAの注文管理機能を効果的に実装することができます。