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

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

StringAddは、既存の文字列（string型変数）の末尾に、別の文字列を結合するための関数です。

実務におけるMQL5開発では、単に文字を表示するだけでなく、「現在の価格」「ポジションの利益」「マジックナンバー」といった動的な情報を組み合わせて、一つのメッセージを生成する機会が頻繁にあります。

実務での主な活用シーン：
* ログ出力の構築: Print関数で書き出すログに、複数の変数を連結して詳細な履歴を残す。
* 注文コメントの生成: オーダーを出す際に、どのロジックでエントリーしたかを識別するためのコメントを作成する。
* チャート上のラベル表示: インジケーターやEAの状態（Spread、現在のフェーズなど）をリアルタイムに更新して表示する。

初心者がつまずきやすいポイントは、「元の変数が直接書き換えられる」という点です。新しい変数に代入するのではなく、第一引数に指定した変数そのものに文字が追加されるため、元の文字列を保持しておきたい場合は注意が必要です。

2. 構文と戻り値

StringAdd関数の構造は非常にシンプルです。

bool StringAdd(
   string&  string_var,        // 結合先の文字列変数（参照渡し）
   string   add_substring      // 追加したい文字列
);

パラメーター

1. string_var: ベースとなる文字列変数です。この変数の末尾に文字が追加されます。&がついている通り「参照渡し」であるため、関数実行後、この変数の中身が直接更新されます。
2. add_substring: 追加したい文字列です。

戻り値

• true: 結合に成功した場合。
• false: 失敗した場合。メモリ不足などで失敗することが稀にありますが、通常のエントリーレベルのコードでは成功が一般的です。失敗した場合は GetLastError() で詳細を確認できます。

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

以下は、EA（エキスパートアドバイザー）がエントリーする際に、詳細な注文理由を一つの文字列にまとめ、ログ出力および注文コメントとして利用する実践的な例です。

void OnTick()
{
    // 1. ベースとなる文字列を用意
    string tradeNote = "Entry_Signal:";

    // 2. 追加したい動的な情報を取得
    string strategyName = "GoldenCross";
    double currentPrice = SymbolInfoDouble(_Symbol, SYMBOL_BID);

    // 3. StringAddで文字列を構築
    // 戦略名を追加
    if(!StringAdd(tradeNote, strategyName))
    {
        Print("文字列の結合に失敗しました。エラーコード:", GetLastError());
    }

    // 区切り文字を追加
    StringAdd(tradeNote, " | Price:");

    // 数値を文字列に変換して追加
    StringAdd(tradeNote, DoubleToString(currentPrice, _Digits));

    // 4. 結果の出力
    // 最終的な tradeNote は "Entry_Signal:GoldenCross | Price:145.250" のようになる
    Print("【デバッグ情報】: ", tradeNote);

    /* 実際の注文処理での利用イメージ
    trade_request.comment = tradeNote;
    */
}

このコードでは、+ 演算子を使って tradeNote = tradeNote + strategyName; と書くのと同等の処理をしていますが、StringAdd を使うことで「既存の文字列に対して操作を加えている」という意図が明確になり、メモリ効率を意識したクオンツらしい実装になります。

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

① 元の文字列が上書きされる

前述の通り、StringAddは第一引数の変数を書き換えます。

string a = "USD";
StringAdd(a, "JPY");
// この時点で a は "USDJPY" に変わっている

元の “USD” という値を後で使いたい場合は、別の変数にコピーしておく必要があります。

② 数値や型違いの直接結合は不可

StringAdd の第二引数は string 型である必要があります。double 型や int 型の変数をそのまま入れようとするとコンパイルエラーになります。必ず DoubleToString() や IntegerToString()、あるいは型キャスト (string) を利用して文字列に変換してから渡してください。

③ ループ内での大量結合

非常に長い文字列を数千回、数万回のループ内で結合する場合、メモリの再確保が発生しパフォーマンスに影響が出ることがあります。通常のEA開発では問題になりませんが、膨大なバックテストデータを解析するツールなどを作る際は、StringConcatenate や、事前にバッファを確保する設計を検討してください。

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

アルゴリズムトレードにおいて、StringAddを使ってどれほど完璧なロジックを記述しても、それを実行する「環境」が劣悪であれば利益は生まれません。多くの個人開発者が陥る罠が、自宅のPCや一般的な光回線でEAを動かしてしまうことです。

FXの世界では、ミリ秒（1000分の1秒）単位の遅延が「スリッページ」を引き起こし、本来得られたはずの利益を削り取ります。自宅PCからの注文は、プロバイダーの混雑や物理的な距離によるネットワーク遅延（レイテンシ）の影響をダイレクトに受け、証券会社のサーバーに届く頃には価格が変動しているケースが多々あります。この数ピップスの積み重ねが、長期的なバックテスト結果とリアルトレードの結果が乖離する最大の原因です。

約定スピードを極限まで高め、ロジック通りに利益を積み上げるには、証券会社のサーバーに物理的に近いデータセンターに設置された「専用VPS」が必須です。24時間安定して稼働し、超低遅延で注文を執行できる環境を整えることは、勝つためのインフラ投資として、手法を磨くこと以上に重要であることを忘れないでください。