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

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

StringToUpperは、指定した文字列に含まれるすべての小文字を、その場で「大文字」に変換するための関数です。

実務開発において、この関数は「データの正規化（表記揺れの吸収）」に非常に重宝します。例えば、EAの外部パラメーター（input）でユーザーに通貨ペア名を手入力させる場合、ユーザーは “eurusd”、”EurUsd”、”EURUSD” など、さまざまな形式で入力する可能性があります。

MQL5では文字列の比較において「大文字と小文字」を厳密に区別するため、これらが一致しないと「指定された通貨ペアが見つからない」といったバグに繋がります。あらかじめ StringToUpper を使ってすべて大文字に統一しておくことで、こうした人為的なミスを未然に防ぎ、堅牢なプログラムを作成することが可能になります。

2. 構文と戻り値

StringToUpper関数の構文は以下の通りです。

bool StringToUpper(
   string& string_var      // 変換対象の文字列変数
);

パラメーター

• string& string_var
  変換したい文字列を格納した変数を指定します。参照渡し（&）であるため、関数を呼び出すと、引数に渡した変数そのものの内容が書き換わります。

戻り値

• bool型
  変換に成功した場合は true を、失敗した場合は false を返します。

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

以下は、ユーザーがパラメーター入力した通貨ペア名を大文字に正規化し、現在のチャートの通貨ペアと一致するかを確認する実用的なコード例です。

//+------------------------------------------------------------------+
//|                                              SampleStringToUpper |
//+------------------------------------------------------------------+
#property strict

// 外部入力パラメーター（小文字で入力される可能性がある）
input string TargetSymbol = "eurusd"; 

void OnStart()
{
    // 入力された文字列を作業用変数にコピー
    string normalizedSymbol = TargetSymbol;

    // 文字列をすべて大文字に変換
    // 参照渡しなので normalizedSymbol の中身が直接書き換わる
    if(StringToUpper(normalizedSymbol))
    {
        Print("変換後の文字列: ", normalizedSymbol); // "EURUSD" と出力される

        // 現在のチャートの通貨ペア名と比較（Symbol()は大文字を返すため）
        if(normalizedSymbol == Symbol())
        {
            Print("入力された通貨ペアは現在のチャートと一致します。");
        }
        else
        {
            Print("入力された通貨ペアは現在のチャートと異なります。");
        }
    }
    else
    {
        Print("文字列の変換に失敗しました。");
    }
}

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

1. 変数そのものが書き換わる

StringToUpper は、新しい文字列を「返す」のではなく、引数に渡した「変数の中身を書き換える」関数です。元の小文字の状態を保持しておきたい場合は、必ず別の変数にコピーしてから実行してください。

2. 定数は渡せない

StringToUpper("eurusd") のように、直接文字列のリテラル（定数）を引数に渡すことはできません。必ず string 型の変数に一度格納してから渡す必要があります。

3. 全角文字や記号への影響

この関数はアルファベット（a-z）を大文字（A-Z）に変換するものであり、日本語（全角文字）や数字、記号には影響を与えません。全角のアルファベットについても、環境によっては変換されない場合があるため、基本的には半角アルファベットの処理に限定して使用するのが安全です。

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

アルゴリズムトレードにおいて、ロジックの正確さと同様に、あるいはそれ以上に重要なのが「約定スピード」です。今回解説したような文字列処理の最適化はプログラムの健全性を高めますが、どんなに優れたコードを書いても、実行環境が劣悪であればすべてが台無しになります。

特に、自宅のPCから一般的なインターネット回線を通じて海外業者のサーバーへ注文を出す場合、物理的な距離に起因するネットワーク遅延（レイテンシ）は避けられません。数ミリ秒の遅延が原因で、表示されていた価格から乖離した場所で約定する「スリッページ」が発生し、それが積み重なれば理論上の利益は簡単に吹き飛びます。プロのクオンツエンジニアとして断言できるのは、極限まで約定スピードを高め、安定した利益を追求するには、取引サーバーに物理的に近い場所にある「専用のVPS（仮想専用サーバー）」の活用が必須であるということです。24時間365日、無停止かつ低レイテンシで稼働する環境を整えることこそが、自動売買における真のスタートラインといえます。