この記事では、MQL4開発で必須となる以下の5つ（＋α）の関数について、基本的な使い方から実践的な注意点まで徹底的に解説します。

• Print() — ログへの出力
• Comment() — チャート上への表示
• Alert() — ポップアップ通知
• GetLastError() — エラーコードの取得
• ResetLastError() — エラーコードのリセット

Print関数 — エキスパートログへの出力

基本的な使い方

Print関数は、MetaTraderの「エキスパート」タブ（ログ）にメッセージを出力する、最も基本的なデバッグ関数です。開発中に変数の値を確認したり、処理の流れを追跡したりするのに欠かせません。

void OnTick()
{
    double currentPrice = Ask;
    int spread = MarketInfo(Symbol(), MODE_SPREAD);

    Print("現在のAsk価格: ", currentPrice);
    Print("スプレッド: ", spread, " ポイント");
    Print("通貨ペア: ", Symbol(), " 時間足: ", Period());
}

Print関数はカンマ区切りで複数の値を渡すことができ、文字列・整数・小数点数などさまざまなデータ型を自動的に文字列に変換して出力してくれます。

データ型ごとの表示仕様

Print関数で各データ型を出力するときの仕様を覚えておきましょう。

void OnInit()
{
    // 整数型：そのまま数値で表示
    int intValue = 12345;
    Print("int型: ", intValue);           // → int型: 12345

    // double型：小数点以下の桁数は自動調整
    double dblValue = 1.23456789;
    Print("double型: ", dblValue);        // → double型: 1.23456789

    // bool型：trueまたはfalseで表示
    bool boolValue = true;
    Print("bool型: ", boolValue);         // → bool型: true

    // datetime型：日時形式で表示
    datetime dtValue = TimeCurrent();
    Print("datetime型: ", dtValue);       // → datetime型: 2024.01.15 12:30:00
}

出力先について

Print関数の出力先は2か所あります。

• エキスパートタブ：MetaTrader画面下部の「エキスパート」タブにリアルタイム表示
• ログファイル：MQL4/Logs フォルダ内にテキストファイルとしても記録される

ログファイルに残るため、後から問題を調査するときにも役立ちます。ただし、OnTick内で大量にPrintを呼ぶとパフォーマンスに影響する場合があるので、本番稼働時には不要なPrintは削除またはコメントアウトしましょう。

Comment関数 — チャート画面への表示

基本的な使い方

Comment関数は、チャートの左上にテキストを表示する関数です。リアルタイムで変数の値を視覚的に確認したいときに便利です。

void OnTick()
{
    double bid = Bid;
    double ask = Ask;
    int spread = (int)((ask - bid) / Point);

    Comment("Bid: ", bid, "\n",
            "Ask: ", ask, "\n",
            "Spread: ", spread, " points\n",
            "Time: ", TimeToStr(TimeCurrent(), TIME_SECONDS));
}

改行するには「\n」を使います。これにより、複数行にわたる情報をきれいに表示できます。

Comment関数の重要な注意点

Comment関数には大きな特徴（欠点）があります。最後に呼び出したComment関数の内容で上書きされるという点です。

void OnTick()
{
    Comment("1行目のメッセージ");
    Comment("2行目のメッセージ");  // ← これだけが表示される！
}

上記の場合、チャートには「2行目のメッセージ」しか表示されません。複数の情報を表示したい場合は、1回のComment呼び出しにすべての情報をまとめる必要があります。

また、Comment関数の表示をクリア（消去）したい場合は、空文字を渡します。

Comment("");  // チャート左上の表示をクリア

Alert関数 — ポップアップ通知

基本的な使い方

Alert関数は、ポップアップダイアログを表示して、音とともにユーザーに通知する関数です。重要なイベント（エントリーシグナル発生、エラー検知など）の通知に使います。

void OnTick()
{
    static datetime lastAlertTime = 0;
    datetime currentTime = TimeCurrent();

    // RSIが30以下になったらアラート（同じ足で1回だけ）
    double rsi = iRSI(Symbol(), 0, 14, PRICE_CLOSE, 0);

    if(rsi < 30.0 && lastAlertTime != iTime(Symbol(), 0, 0))
    {
        Alert(Symbol(), " RSIが30以下です！ RSI=", NormalizeDouble(rsi, 2));
        lastAlertTime = iTime(Symbol(), 0, 0);
    }
}

Alert関数の注意点

Alert関数には以下の注意点があります。

• バックテストでは動作しない：ストラテジーテスターでのバックテスト時にはAlertは表示されません。バックテスト中のデバッグにはPrint関数を使いましょう。
• 日本語の一部が文字化けする場合がある：環境によっては日本語表示が正しくされないことがあります。重要な情報は英数字で出力するのが安全です。
• 連続呼び出しに注意：OnTick内で条件なしにAlertを呼ぶと、ティックごとにポップアップが出て操作不能になります。必ず条件制御を入れましょう。

GetLastError関数 — エラーコードの取得

基本的な使い方

GetLastError関数は、直前の操作で発生したエラーのコード（番号）を取得する関数です。注文送信やファイル操作などの後にエラーチェックを行う際に使います。

void OnTick()
{
    int ticket = OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0, "Test", 0, 0, clrBlue);

    if(ticket < 0)
    {
        int errorCode = GetLastError();
        Print("注文エラー！ エラーコード: ", errorCode);
    }
    else
    {
        Print("注文成功！ チケット番号: ", ticket);
    }
}

よく見るエラーコード一覧

以下は、MQL4開発でよく遭遇するエラーコードの一覧です。

【超重要】GetLastErrorは2度呼ぶとリセットされる！

GetLastError関数には非常に重要な仕様があります。一度呼び出すと、内部のエラーコードが0にリセットされてしまうのです。

// ★ ダメな例
int ticket = OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0, "", 0, 0, clrBlue);
if(ticket < 0)
{
    Print("エラーコード: ", GetLastError());   // ← 1回目：正しいエラーコードが取得できる
    Print("エラーコード: ", GetLastError());   // ← 2回目：0が返る！（リセット済み）
}

// ★ 正しい例：変数で受けてから使う
int ticket = OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0, "", 0, 0, clrBlue);
if(ticket < 0)
{
    int err = GetLastError();  // まず変数に格納！
    Print("エラーコード: ", err);
    Alert("注文失敗 エラー: ", err);  // 何度でも使える
}

これはMQL4開発でよくあるミスです。GetLastError()は必ず一度だけ呼び出して変数に保存してから使いましょう。

ResetLastError関数 — エラーコードのリセット

ResetLastError関数は、定義済み変数_LastErrorに格納されているエラーコードを0（エラーなし）にリセットするための関数です。

void OnTick()
{
    // エラーコードを事前にリセット
    ResetLastError();

    int ticket = OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0, "Test", 0, 0, clrBlue);

    if(ticket < 0)
    {
        int err = GetLastError();
        Print("注文エラー: ", err);
    }
}

なぜリセットが必要なのか？

GetLastError()は「最後に発生したエラー」を返します。つまり、以前の処理で発生したエラーコードが残っている可能性があるのです。特定の処理のエラーだけを正確に検知したい場合は、処理の直前にResetLastError()を呼ぶのが定石です。

// 定石パターン：リセット → 処理 → エラーチェック
ResetLastError();           // ① リセット
bool result = OrderClose(ticket, lots, price, 3, clrRed);  // ② 処理実行
int err = GetLastError();   // ③ エラー取得（変数に格納）
if(err != 0)
{
    Print("決済エラー: ", err);
}

ErrorDescription関数 — エラーコードを文章に変換

エラーコードの番号だけでは、何が起きたのかすぐにはわかりません。そこで便利なのがErrorDescription関数です。この関数を使うと、エラーコードを人間が読める英語の文章に変換できます。

ただし、この関数はMQL4に標準で組み込まれているわけではなく、stdlib.mqhというライブラリファイルをインクルードする必要があります。

#include <stdlib.mqh>  // ErrorDescription関数を使うために必要

void OnTick()
{
    ResetLastError();

    int ticket = OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0, "Test", 0, 0, clrBlue);

    if(ticket < 0)
    {
        int err = GetLastError();
        Print("エラーコード: ", err, " 内容: ", ErrorDescription(err));
        // 例：エラーコード: 134 内容: not enough money
    }
}

エラーの原因がすぐにわかるため、デバッグの効率が格段に上がります。ぜひstdlib.mqhのインクルードを習慣にしましょう。

実践例 — 5つの関数を組み合わせたデバッグ付きEA

ここまで学んだ関数を組み合わせた、実践的なサンプルコードをご紹介します。

#include <stdlib.mqh>

input double LotSize = 0.1;
input int MagicNumber = 12345;

void OnTick()
{
    // 現在の状態をチャートに表示
    Comment("=== デバッグ情報 ===\n",
            "通貨ペア: ", Symbol(), "\n",
            "Bid: ", Bid, "  Ask: ", Ask, "\n",
            "スプレッド: ", MarketInfo(Symbol(), MODE_SPREAD), "\n",
            "保有ポジション: ", CountOrders(), "\n",
            "口座残高: ", AccountBalance(), "\n",
            "更新時刻: ", TimeToStr(TimeCurrent(), TIME_SECONDS));

    // 簡単な売買ロジック（例：移動平均のクロス）
    double maFast = iMA(Symbol(), 0, 10, 0, MODE_SMA, PRICE_CLOSE, 0);
    double maFastPrev = iMA(Symbol(), 0, 10, 0, MODE_SMA, PRICE_CLOSE, 1);
    double maSlow = iMA(Symbol(), 0, 25, 0, MODE_SMA, PRICE_CLOSE, 0);
    double maSlowPrev = iMA(Symbol(), 0, 25, 0, MODE_SMA, PRICE_CLOSE, 1);

    // ゴールデンクロスで買い
    if(maFastPrev <= maSlowPrev && maFast > maSlow && CountOrders() == 0)
    {
        Print("ゴールデンクロス検出！ 買い注文を送信します。");
        Print("MA(10)=", maFast, " MA(25)=", maSlow);

        ResetLastError();  // エラーをリセット
        int ticket = OrderSend(Symbol(), OP_BUY, LotSize, Ask, 3, 0, 0,
                               "MA Cross Buy", MagicNumber, 0, clrBlue);

        int err = GetLastError();  // 変数に格納（1回だけ呼ぶ！）

        if(ticket >= 0)
        {
            Print("注文成功！ チケット: ", ticket);
        }
        else
        {
            Print("注文失敗！ エラーコード: ", err,
                  " 内容: ", ErrorDescription(err));
            Alert("注文失敗！ Error: ", err, " ", ErrorDescription(err));
        }
    }
}

// 保有ポジション数をカウントする関数
int CountOrders()
{
    int count = 0;
    for(int i = OrdersTotal() - 1; i >= 0; i--)
    {
        if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES))
        {
            if(OrderSymbol() == Symbol() && OrderMagicNumber() == MagicNumber)
                count++;
        }
    }
    return count;
}

このサンプルでは、以下のようにデバッグ関数を使い分けています。

• Comment：リアルタイムの状態監視（チャート上に常時表示）
• Print：処理の流れやシグナル検出の記録（ログに残る）
• Alert：注文失敗などの重要イベントの即時通知
• ResetLastError → GetLastError：正確なエラーコード取得の定石パターン
• ErrorDescription：エラー内容の可読化

まとめ — デバッグ関数の使い分け

最後に、各関数の特徴と使い分けを表で整理します。

デバッグ関数を上手に使いこなすことは、MQL4開発の効率を大きく左右します。特に「GetLastErrorは変数で一度受けてから使う」と「処理前にResetLastErrorでリセットする」の2つは、ぜひ今日から実践してください。

デバッグの精度が上がれば、EA開発のスピードも自然と上がっていきますよ！

投稿 【MQL4】デバッグに必須！Print・Alert・Comment・GetLastError・ResetLastErrorの使い方を徹底解説 は 自動売買を作ろう！ に最初に表示されました。

エラーコード定数​（ERR_○○）は、プログラム実行時のエラー内容を知るための定数です。

例えば、注文が通らなかった場合、ERR_INVALID_TRADE_VOLUMEなどのエラー定数が使用されます。

エラーコードは、システムが自動的に_LastError変数に格納するものなので、プログラムに記述する必要はありませんが、デバッグするときに非常に便利なので、覚えておくと良いでしょう。

エラーコード定数は、以下の関数で使います。

• GetLastError関数：最近のエラーコードを返す関数
• ErrorDescription関数：エラーコードの内容を返す関数

エラーコード定数​（ERR_○○）

エラーコード定数​（ERR_○○）の使い方

エラーが起こったとき、システムが自動的に_LastError変数に、適切なエラーコード定数を格納します。

_LastError変数の値を取得するために、GetLastError関数を使います。

GetLastError関数を使うことで、エラーコードの番号を知ることができます。

エラーコードの番号を知ることができれば、エラーの内容をErrorDescription関数を使って表示させることができるので、デバッグするときにとても役立ちます。

例えば、以下のように使用します。

#property strict

//ライブラリをインクルード
#include <stdlib.mqh>

//+------------------------------------------------------------------+
//| スクリプトスタート
//+------------------------------------------------------------------+
void OnStart()
{
    int ea_ticket_res;

    // エラーになるようにLot:0で発注
    ea_ticket_res = OrderSend(  // オーダー送信
        Symbol(),               // 通貨ペア
        OP_BUY,                 // オーダータイプ[OP_BUY / OP_SELL]
        0.00000,                // ロット[0.01単位]
        Ask,                    // オーダープライスレート
        20,                     // スリップ上限    (int)[分解能 0.1pips]
        0,                      // ストップレート
        0,                      // リミットレート
        "エラーテスト",          // オーダーコメント
        999,                    // マジックナンバー(管理用)
        0,                      // オーダーリミット時間
        clrRed                  // オーダーアイコンカラー
    );

    //オーダーエラー
    if ( ea_ticket_res == -1 ) { 

        int error_code;
        string error_detail;

        // エラーコード取得
        error_code = GetLastError(); 

        // エラー内容取得
        error_detail = ErrorDescription(error_code);

        if ( error_code != ERR_NO_ERROR ) {
            printf( "エラーコード:%d 内容:%s" , error_code , error_detail);
        }
    }
}

上記のプログラムを実行することで、以下のような結果を得ることができます。

「エラーコード: 4051 詳細：invalid function parameter value」

プログラム例

以下は、エラーコード定数を活用して、注文エラー発生時にエラー内容をログに出力するEAのサンプルプログラムです。

#property strict

//ライブラリをインクルード
#include <stdlib.mqh>

//+------------------------------------------------------------------+
//| Expert initialization function                                     |
//+------------------------------------------------------------------+
int OnInit()
{
    Print("EA初期化完了");
    return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| Expert deinitialization function                                   |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
    Print("EA終了");
}

//+------------------------------------------------------------------+
//| Expert tick function                                               |
//+------------------------------------------------------------------+
void OnTick()
{
    static bool ordered = false;

    // 一度だけ注文を試みる
    if ( !ordered ) {
        ordered = true;

        int ticket;

        // わざとロット数を0にしてエラーを発生させる
        ticket = OrderSend(
            Symbol(),           // 通貨ペア
            OP_BUY,             // 買い注文
            0.00000,            // ロット数（0でエラー発生）
            Ask,                // 現在のAsk価格
            20,                 // スリッページ
            0,                  // ストップロス
            0,                  // テイクプロフィット
            "エラーテスト",      // コメント
            12345,              // マジックナンバー
            0,                  // 有効期限
            clrBlue             // 矢印の色
        );

        // エラー処理
        if ( ticket == -1 ) {
            int err = GetLastError();
            string desc = ErrorDescription(err);

            // エラーコードと内容をログに出力
            Print("注文失敗 - エラーコード: ", err, " 内容: ", desc);

            // エラーの種類に応じた処理
            if ( err == ERR_INVALID_TRADE_VOLUME ) {
                Print("ロット数が不正です。ロット数を確認してください。");
            }
            else if ( err == ERR_NOT_ENOUGH_MONEY ) {
                Print("証拠金が不足しています。");
            }
            else if ( err == ERR_TRADE_NOT_ALLOWED ) {
                Print("自動売買が許可されていません。設定を確認してください。");
            }
            else if ( err == ERR_INVALID_STOPS ) {
                Print("ストップロスまたはテイクプロフィットの値が不正です。");
            }
            else if ( err == ERR_SERVER_BUSY || err == ERR_BROKER_BUSY ) {
                Print("サーバーがビジー状態です。後でリトライしてください。");
            }
            else {
                Print("その他のエラーが発生しました。");
            }
        }
        else {
            Print("注文成功 - チケット番号: ", ticket);
        }
    }
}

このサンプルプログラムでは、わざとロット数を0にして注文エラーを発生させ、GetLastError関数でエラーコードを取得し、ErrorDescription関数でエラーの詳細を表示しています。さらに、エラーコード定数を使って条件分岐を行い、エラーの種類に応じたメッセージを出力しています。

【MQLプログラミング基礎】列挙型とは？配列との違いを理解して使いこなそう！

目次 列挙型とは？列挙型と配列の違い列挙型と配列のデータの取り出し方法の違い列挙型と配列のデータの取り出し方法のまとめ列挙型の構造と使い方列挙型の構造列挙型の使い方列挙型はどこで使われているのか列挙型のプログラム例まとめ

mql-programing.com

【MQL4プログラミング】自動売買の作り方！FXで使えるテンプレートあり

目次 はじめにFX自動売買とはFX自動売買を作るための準備FX自動売買の作り方口座凍結の対策をするプログラムテンプレートを作る決済ロジックをプログラミングするプログラムテンプレートを作るエントリーロジックをプログラミング

mql-programing.com

MQL4リファレンス【全データ一覧】

/*! elementor - v3.6.5 - 27-04-2022 */.e-container.e-container--row .elementor-spacer-inner{width:var(--spacer-size)}.e-

mql-programing.com

投稿 【MQL4定数】エラーコード定数​（ERR_○○） は 自動売買を作ろう！ に最初に表示されました。