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

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

StringLenは、指定した文字列の文字数を取得するための非常にシンプルな関数です。しかし、実務でのMQL5開発において、その役割は極めて重要です。

例えば、EA（エキスパートアドバイザー）のパラメーター設定でユーザーが入力した「通貨ペア名」や「マジックナンバーの識別用コメント」が正しいフォーマットであるかを確認する際によく使われます。また、外部ファイルからデータを読み込む際や、Webリクエストの結果をパース（解析）する際にも、文字列の長さを判定して処理を分岐させるロジックは不可欠です。

初心者が特につまずきやすいのは、「文字数」と「バイト数」の混同です。MQL5はUnicode（ユニコード）を採用しているため、全角文字も1文字としてカウントされますが、通信処理やバイナリ操作を行う際にはこの「文字としての長さ」を正確に把握していないと、データの切り出し位置がズレて重大なバグ（ランタイムエラー）を引き起こす原因となります。

2. 構文と戻り値

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

int StringLen(
   string  string_value      // 対象となる文字列
);

パラメーター

• string_value: 文字数を調べたい対象の文字列を指定します。

戻り値

• int型: 文字列内の文字数を返します。
• 文字列が空（””）の場合は 0 を返します。

※注意：内部的な終端文字（NULL文字）はカウントに含まれません。目に見える文字数がそのまま返ってくると考えて差し支えありません。

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

以下は、EAの初期化時（OnInit）に、ユーザーが入力した「トレードコメント」の長さをチェックし、ブローカーの制限（一般的に31文字前後）を超えていないかを確認する実用的なコード例です。

//--- 入力パラメーター
input string InpTradeComment = "MyExpertAdvisor_v1.0"; // トレード用コメント

//+------------------------------------------------------------------+
//| Expert initialization function                                   |
//+------------------------------------------------------------------+
int OnInit()
{
    // StringLenを使って入力されたコメントの長さを取得
    int commentLength = StringLen(InpTradeComment);

    Print("設定されたコメント: ", InpTradeComment);
    Print("文字数: ", commentLength);

    // 一般的なブローカーのコメント制限（例：31文字）をチェック
    if(commentLength > 31)
    {
        Alert("エラー：トレードコメントが長すぎます（現在 ", commentLength, " 文字）。31文字以内で設定してください。");
        return(INIT_PARAMETERS_INCORRECT); // 初期化失敗として終了
    }

    // 文字列が空の場合の警告
    if(commentLength == 0)
    {
        Print("通知：コメントが空です。");
    }

    return(INIT_SUCCEEDED);
}

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

1. スペース（空白）もカウントされる:
   "EURUSD " のように末尾に半角スペースが入っている場合、StringLenは「7」を返します。これが原因で、通貨ペアの不一致エラーが発生することが多々あります。必要に応じて StringTrimRight などで空白を除去してから長さを測るのがベストプラクティスです。

2. NULL文字列と空文字列の違い:
   変数が初期化されていない状態でも、MQL5の string 型はデフォルトで空文字列（””）として扱われるため、基本的には 0 が返されます。ただし、外部DLLとの連携時には挙動が異なる場合があるため注意してください。

3. マルチバイト文字の扱い:
   前述の通り、MQL5はUnicodeです。"こんにちは" という文字列に対して StringLen を実行すると、結果は 5 になります。バイト数（10バイトなど）ではないため、通信プロトコルを自作する場合などは混同しないようにしましょう。

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

アルゴリズムの論理構成が完璧であっても、実際の運用環境がそのパフォーマンスを台無しにすることがあります。特に日本の自宅PCから海外の取引サーバーへ注文を出す場合、ネットワークの物理的な距離に起因する「レイテンシ（遅延）」が数十ミリ秒から数百ミリ秒発生します。この遅延は、一瞬の価格変動を捉えるスキャルピングや高頻度トレードにおいて、スリッページによる致命的な損失を招きます。

プロのクオンツエンジニアが共通して行う対策は、取引サーバーに物理的に近い場所にある「専用のVPS（仮想専用サーバー）」の利用です。自宅PCでの運用は停電やOSの自動アップデート、回線トラブルのリスクも抱えています。極限まで約定スピードを高め、24時間365日安定した取引を維持するためには、低遅延なネットワーク環境が構築されたVPSの導入が、ロジックの最適化と同じくらい、あるいはそれ以上に重要であることを忘れてはいけません。