MQL4では、チャートの見た目や動作を制御するためのチャートプロパティ定数が用意されています。この記事では、ENUM_CHART_PROPERTY_INTEGER、ENUM_CHART_PROPERTY_STRING、ENUM_CHART_PROPERTY_DOUBLEの3種類の列挙型を中心に、チャート設定の操作方法をわかりやすく解説します。

チャートプロパティを操作する関数の全体像

MQL4では、チャートプロパティの値を「設定する関数」と「取得する関数」がデータ型ごとにペアで用意されています。

これらの関数の第1引数にはチャートIDを指定します。0を指定すると現在のチャートを意味します。第2引数に、これから説明する列挙型の定数を渡すことで、どのプロパティを操作するかを指定します。

ENUM_CHART_PROPERTY_INTEGER — 整数型プロパティ

最も種類が多く、よく使うのがこの整数型プロパティです。チャートの表示/非表示の切り替え、色の設定、モードの変更など幅広い操作ができます。

表示モード系のプロパティ

表示要素の ON/OFF 系プロパティ

色の設定用プロパティ

チャートの配色もすべてプログラムから制御できます。color型の値を指定します。

読み取り専用のプロパティ

以下のプロパティは値の取得のみ可能で、プログラムから変更はできません（読み取り専用 = r/o）。

実践サンプル：チャートの配色をカスタマイズする

以下はEAのOnInit()内でチャートの見た目を一括変更する例です。

int OnInit()
{
   // チャート表示をローソク足に変更
   ChartSetInteger(0, CHART_MODE, CHART_CANDLES);
   
   // 背景色をダークブルーに設定
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, clrMidnightBlue);
   
   // グリッドを非表示にする（背景色と同色でも可）
   ChartSetInteger(0, CHART_SHOW_GRID, false);
   
   // 陽線（Bull）の色設定
   ChartSetInteger(0, CHART_COLOR_CANDLE_BULL, clrDodgerBlue);
   ChartSetInteger(0, CHART_COLOR_CHART_UP, clrDodgerBlue);
   
   // 陰線（Bear）の色設定
   ChartSetInteger(0, CHART_COLOR_CANDLE_BEAR, clrMediumOrchid);
   ChartSetInteger(0, CHART_COLOR_CHART_DOWN, clrMediumOrchid);
   
   // Askラインを表示する
   ChartSetInteger(0, CHART_SHOW_ASK_LINE, true);
   
   // 設定を反映
   ChartRedraw();
   
   return(INIT_SUCCEEDED);
}

ポイント：ChartSetInteger()を呼んだだけでは画面にすぐ反映されないことがあります。確実に描画を更新したい場合は、最後にChartRedraw()を呼びましょう。

ENUM_CHART_PROPERTY_DOUBLE — 浮動小数点型プロパティ

Double型のプロパティは数が少なく、主にチャートの価格範囲を取得するために使います。

実践サンプル：現在のチャート価格範囲を取得する

void OnTick()
{
   // 現在チャートに表示されている価格範囲を取得
   double priceMin = ChartGetDouble(0, CHART_PRICE_MIN);
   double priceMax = ChartGetDouble(0, CHART_PRICE_MAX);
   
   Print("表示中の価格範囲: ", priceMin, " ～ ", priceMax);
}

CHART_PRICE_MINとCHART_PRICE_MAXは、画面上に「今見えている」範囲の最小・最大価格です。スクロールやズームに応じて動的に変化するため、現在の表示状態を知りたいときに便利です。

ENUM_CHART_PROPERTY_STRING — 文字列型プロパティ

文字列型のプロパティは現在1つだけです。

実践サンプル：チャートにコメントを表示する

void OnTick()
{
   // ChartSetString でチャートコメントを設定
   string info = "スプレッド: " + IntegerToString(SymbolInfoInteger(_Symbol, SYMBOL_SPREAD))
               + " / Bid: " + DoubleToString(Bid, _Digits);
   
   ChartSetString(0, CHART_COMMENT, info);
   ChartRedraw();
}

// コメントの取得
void ShowCurrentComment()
{
   string currentComment = ChartGetString(0, CHART_COMMENT);
   Print("現在のコメント: ", currentComment);
}

ChartSetString()によるCHART_COMMENTの設定は、Comment()関数と同様にチャート左上にテキストを表示します。Comment()関数との違いは、チャートIDを指定できるため他のチャートウィンドウに対してもコメントを設定できる点です。

応用テクニック：チャートの設定を保存・復元する

EAやインジケーターでチャートの見た目を変更する場合、終了時に元の設定に戻すのがマナーです。以下のパターンを覚えておきましょう。

// グローバル変数に元の設定を保存
color g_origBgColor;
bool  g_origShowGrid;

int OnInit()
{
   // 元の設定を保存
   g_origBgColor  = (color)ChartGetInteger(0, CHART_COLOR_BACKGROUND);
   g_origShowGrid = (bool)ChartGetInteger(0, CHART_SHOW_GRID);
   
   // 新しい設定を適用
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, clrBlack);
   ChartSetInteger(0, CHART_SHOW_GRID, false);
   ChartRedraw();
   
   return(INIT_SUCCEEDED);
}

void OnDeinit(const int reason)
{
   // 元の設定を復元
   ChartSetInteger(0, CHART_COLOR_BACKGROUND, g_origBgColor);
   ChartSetInteger(0, CHART_SHOW_GRID, g_origShowGrid);
   ChartRedraw();
}

こうすることで、EAを取り外したときにチャートが元の見た目に戻ります。ユーザーにとって親切な設計になりますので、ぜひ習慣にしてください。

よくある注意点とつまずきポイント

① ChartRedraw()を忘れない

チャートプロパティを変更する関数は、実際にはイベントキューにコマンドを追加するだけです。画面への即時反映が必要な場合は、ChartRedraw()を明示的に呼びましょう。

② 第1引数のチャートID

第1引数に0を指定すると「現在のチャート」を意味します。別のチャートを操作したい場合は、ChartID()やChartFirst()/ChartNext()で取得したIDを使います。

③ 読み取り専用プロパティに注意

CHART_WIDTH_IN_PIXELSやCHART_PRICE_MINなどの読み取り専用（r/o）プロパティに対してSet関数を呼んでも、値は変更されません。公式リファレンスで「r/o」の表記を確認しましょう。

④ 新しく開いたチャートの操作タイミング

ChartOpen()で新しくチャートを開いた直後は、まだデータが読み込まれていない場合があります。CHART_PRICE_MINやCHART_PRICE_MAXを取得しても0が返ることがあるため、少し待つか、次のティックで取得するようにしましょう。

まとめ

MQL4のチャートプロパティ定数は、大きく3つの列挙型に分類されます。

• ENUM_CHART_PROPERTY_INTEGER：色・表示切替・モード設定など（最も種類が多い）
• ENUM_CHART_PROPERTY_DOUBLE：価格範囲・スケール関連
• ENUM_CHART_PROPERTY_STRING：チャートコメント

操作にはChartSetInteger()/ChartGetInteger()、ChartSetDouble()/ChartGetDouble()、ChartSetString()/ChartGetString()の6つの関数を使い分けます。

特に、EAやインジケーターでチャートの配色カスタマイズや情報表示を行う際に必須の知識となりますので、まずは本記事のサンプルコードを動かして、チャートプロパティの変更を体験してみてください！

投稿 【MQL4】チャート設定定数を完全理解！ENUM_CHART_PROPERTY_INTEGER・STRING・DOUBLEの使い方 は 自動売買を作ろう！ に最初に表示されました。

この「どの価格を使うか」を指定するために用意されているのが、ENUM_APPLIED_PRICE（適用価格の列挙型）です。全部で7種類の定数があり、iMA()やiRSI()などの組み込み関数で頻繁に使われます。

この記事では、7つの価格定数それぞれの意味と計算式、そして実際のコードでの使い方をわかりやすく解説します。

ENUM_APPLIED_PRICEとは？

ENUM_APPLIED_PRICEは、MQL4で定義されている列挙型（enum）のひとつです。テクニカル指標の計算に使う「価格の種類」を指定するために使います。

たとえば、移動平均線を計算するiMA()関数のシグネチャを見てみましょう。

double iMA(
   string       symbol,           // 通貨ペア
   int          timeframe,        // 時間足
   int          ma_period,        // 期間
   int          ma_shift,         // シフト
   int          ma_method,        // 移動平均の種類
   int          applied_price,    // 適用価格 ← ここ！
   int          shift             // バーのインデックス
);

このapplied_priceの部分に、ENUM_APPLIED_PRICEの定数を指定します。どの定数を選ぶかによって、計算結果が変わってくるわけです。

7つの価格定数一覧

ENUM_APPLIED_PRICEには、以下の7つの定数が定義されています。

PRICE_CLOSE（終値）— 値: 0

もっとも一般的に使われる適用価格です。各ローソク足の終値（Close）を使って計算します。特にこだわりがなければ、まずはこれを選んでおけば問題ありません。多くのトレーダーやテクニカル分析の教科書でも、終値ベースの計算がデフォルトとされています。

PRICE_OPEN（始値）— 値: 1

各ローソク足の始値（Open）を使って計算します。始値はバーの開始時点の価格なので、「そのバーが始まった瞬間にわかる値」という特徴があります。バックテストやリアルタイム処理で、確定済みの値だけを使いたい場合に選ばれることがあります。

PRICE_HIGH（高値）— 値: 2

各ローソク足の高値（High）を使って計算します。高値ベースの移動平均線は、レジスタンスライン（上値抵抗線）のような役割として活用できます。

PRICE_LOW（安値）— 値: 3

各ローソク足の安値（Low）を使って計算します。安値ベースの移動平均線は、サポートライン（下値支持線）のような役割として活用できます。PRICE_HIGHと組み合わせて移動平均チャネルを作る使い方が人気です。

PRICE_MEDIAN（中間値）— 値: 4

計算式は (High + Low) / 2 です。ローソク足の高値と安値のちょうど中間の価格、つまりそのバーの「値幅の中心」を使います。終値の偏りを排除し、そのバーの価格帯の中心で計算したいときに使います。

PRICE_TYPICAL（典型値）— 値: 5

計算式は (High + Low + Close) / 3 です。Median Price（中間値）に終値を加えて3で割った値で、中間値よりも実際の値動きの結果（終値）を反映した価格になります。CCI（商品チャネル指数）などのインジケーターでは、このTypical Priceが標準的に使われています。

PRICE_WEIGHTED（加重終値）— 値: 6

計算式は (High + Low + Close + Close) / 4 です。Typical Price（典型値）の計算式で終値を2回カウントすることで、終値により大きな比重を置いた価格です。「値幅全体も考慮したいけど、やっぱり終値を重視したい」という場合に適しています。

この3つの関係性を整理すると、次のようになります。

• Median Price（HL/2）：ローソク足の値幅の中間値
• Typical Price（HLC/3）：中間値に終値を加え、より実際の値動きに近づけた値
• Weighted Close（HLCC/4）：さらに終値の比重を高め、終値に近づけた値

実際のコードでの使い方

iMA関数での基本的な使用例

もっとも基本的な使い方です。20期間の単純移動平均線を終値ベースで計算します。

void OnTick()
{
   // 20期間SMAを終値(PRICE_CLOSE)で計算
   double ma_close = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

   // 20期間SMAを典型値(PRICE_TYPICAL)で計算
   double ma_typical = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_TYPICAL, 0);

   Print("終値ベースSMA: ", ma_close);
   Print("典型値ベースSMA: ", ma_typical);
}

同じ期間・同じ移動平均の種類でも、適用価格を変えるだけで計算結果が変わることがわかります。

iRSI関数での使用例

RSI（相対力指数）でも適用価格を指定できます。

void OnTick()
{
   // 14期間RSIを終値で計算
   double rsi = iRSI(NULL, 0, 14, PRICE_CLOSE, 0);

   if(rsi > 70)
   {
      Print("RSIが70を超えました（買われすぎ）: ", rsi);
   }
   else if(rsi < 30)
   {
      Print("RSIが30を下回りました（売られすぎ）: ", rsi);
   }
}

HIGH/LOWを使った移動平均チャネルの作成例

PRICE_HIGHとPRICE_LOWを組み合わせると、価格を挟み込むようなチャネル（帯）を作ることができます。

void OnTick()
{
   int period = 20;

   // 高値ベースの移動平均（上側バンド）
   double upper = iMA(NULL, 0, period, 0, MODE_SMA, PRICE_HIGH, 0);

   // 安値ベースの移動平均（下側バンド）
   double lower = iMA(NULL, 0, period, 0, MODE_SMA, PRICE_LOW, 0);

   // 終値ベースの移動平均（中央線）
   double middle = iMA(NULL, 0, period, 0, MODE_SMA, PRICE_CLOSE, 0);

   Print("上側: ", upper, " 中央: ", middle, " 下側: ", lower);

   // 現在価格が上側バンドを超えたら
   if(Ask > upper)
   {
      Print("価格が移動平均チャネルの上側を突破！");
   }
   // 現在価格が下側バンドを下回ったら
   if(Bid < lower)
   {
      Print("価格が移動平均チャネルの下側を突破！");
   }
}

このように、適用価格を変えるだけで同じiMA関数から異なる性質のラインを引くことができます。

input変数でユーザーに選ばせる方法

EAやカスタムインジケーターを作るとき、適用価格をユーザーがパラメーター画面から選べるようにしたいですよね。MQL4では、ENUM_APPLIED_PRICEをinput変数の型として使うことで、自動的にドロップダウンリストが表示されます。

// パラメーター設定
input int                 MAPeriod     = 20;            // 移動平均の期間
input ENUM_MA_METHOD      MAMethod     = MODE_SMA;      // 移動平均の種類
input ENUM_APPLIED_PRICE  MAPrice      = PRICE_CLOSE;   // 適用価格

void OnTick()
{
   double ma = iMA(NULL, 0, MAPeriod, 0, MAMethod, MAPrice, 0);
   Print("MA値: ", ma);
}

このように書くだけで、MetaTraderのパラメーター入力画面に「適用価格」のドロップダウンリストが自動生成されます。ユーザーは「Close price」「Open price」「Median Price (HL/2)」…といった選択肢から直感的に選ぶことができます。

int型で宣言してユーザーに数値を手入力させるよりも、はるかに使いやすく、入力ミスも防げる優れた方法です。EAやインジケーターを配布する場合は、ぜひこの書き方を使いましょう。

定数の整数値を直接使う場合の注意

ENUM_APPLIED_PRICEの各定数には整数値（0〜6）が割り当てられているため、数値を直接指定しても動作します。

// 定数名を使う場合（推奨）
double ma1 = iMA(NULL, 0, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

// 整数値を直接使う場合（非推奨）
double ma2 = iMA(NULL, 0, 20, 0, MODE_SMA, 0, 0);

上の2行はどちらも同じ結果になりますが、整数値を直接書く方法はおすすめしません。理由は以下の通りです。

• 可読性が低い：「0」だけでは何の価格かすぐにわからない
• 保守性が悪い：後から見たとき、あるいは他の人が見たときに意味が伝わらない
• タイプミスに気づきにくい：定数名なら打ち間違えればコンパイルエラーになるが、数値だと範囲外の値でも気づきにくい

常にPRICE_CLOSEやPRICE_TYPICALのような定数名を使うようにしましょう。

どの適用価格を選ぶべきか？

7種類もあると「結局どれを使えばいいの？」と迷いますよね。以下に用途別の目安をまとめます。

迷ったときはPRICE_CLOSEを選んでおけば、まず間違いありません。そこから最適化やバックテストを行って、他の価格定数を試してみるのがよいでしょう。

まとめ

ENUM_APPLIED_PRICEは、テクニカル指標の計算に「どの価格を使うか」を指定するための列挙型です。今回のポイントを振り返りましょう。

• 7種類の定数がある：PRICE_CLOSE（終値）、PRICE_OPEN（始値）、PRICE_HIGH（高値）、PRICE_LOW（安値）、PRICE_MEDIAN（中間値）、PRICE_TYPICAL（典型値）、PRICE_WEIGHTED（加重終値）
• iMA()やiRSI()などの組み込み関数で、applied_priceパラメーターに指定して使う
• input変数の型にENUM_APPLIED_PRICEを使えば、ドロップダウンリストで選択できるようになる
• 整数値の直接指定は動作するが、可読性の観点から定数名を使うべき
• 迷ったらPRICE_CLOSEが最も無難で一般的

適用価格の選択はインジケーターの計算結果に直接影響するため、それぞれの意味を理解しておくことが大切です。この記事を参考に、自分のEAやインジケーターに最適な適用価格を選んでみてください。

投稿 【MQL4】ENUM_APPLIED_PRICE（価格定数）完全ガイド｜PRICE_CLOSEからPRICE_WEIGHTEDまで7種類を徹底解説 は 自動売買を作ろう！ に最初に表示されました。

この記事では、MQL4で使える時間足定数をすべて一覧で紹介し、基本的な使い方からマルチタイムフレーム分析への応用まで、実践的なコード例とともに解説します。

ENUM_TIMEFRAMESとは？

ENUM_TIMEFRAMESは、MetaTraderのチャート時間足を表す列挙型（enum）です。列挙型とは、あらかじめ決められた名前付きの定数をグループ化したもので、「どの時間足か」をプログラム上でわかりやすく指定するために使います。

例えば、1時間足を指定するときに数値の 60 と書くよりも、PERIOD_H1 と書いたほうが圧倒的に読みやすいですよね。これが時間足定数を使う最大のメリットです。

時間足定数の一覧（MQL4）

MQL4で使用できる時間足定数は、特殊な PERIOD_CURRENT を含めて全部で10個です。以下の表にまとめました。

MQL4の整数値は「分」を基準にしています。例えば PERIOD_H1 は60分なので整数値が60、PERIOD_D1 は1440分（24時間×60分）なので1440です。この規則を覚えておくと、値の意味がすぐに理解できます。

MQL5との違いに注意

MQL4からMQL5へコードを移植する際に、最もハマりやすいポイントの一つがこの時間足定数の整数値の違いです。

MQL5ではビットシフトを用いた全く異なる整数値が割り当てられています。

分足（M1〜M30）まではMQL4とMQL5で同じ値ですが、H1以上は完全に異なります。定数名（PERIOD_H1など）を使っていれば問題ありませんが、整数値をハードコードしていると移植時にバグの原因になります。常に定数名を使う習慣をつけましょう。

基本的な使い方

iMA()で別の時間足の移動平均線を取得する

最もよく使うパターンが、iMA() などのテクニカル指標関数に時間足を指定するケースです。

// 現在の通貨ペアの1時間足で、20期間の単純移動平均線を取得
double ma_h1 = iMA(NULL, PERIOD_H1, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

// 日足の20期間移動平均線を取得
double ma_d1 = iMA(NULL, PERIOD_D1, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

第1引数の NULL は現在の通貨ペアを意味し、第2引数に時間足定数を指定します。

iClose()で別の時間足の終値を取得する

// 日足の1本前（昨日）の終値を取得
double yesterday_close = iClose(NULL, PERIOD_D1, 1);

// 4時間足の現在のバーの始値を取得
double h4_open = iOpen(NULL, PERIOD_H4, 0);

Period()で現在の時間足を取得する

// 現在のチャートの時間足を取得
int current_tf = Period();

// 現在の時間足が1時間足かどうか判定
if(Period() == PERIOD_H1)
{
    Print("現在のチャートは1時間足です");
}

Period() 関数は現在のチャートの時間足を整数値で返します。PERIOD_CURRENTを指定したときと同じ時間足のデータが取得されます。

実践テクニック

inputパラメーターでドロップダウン選択にする

EAのパラメーターに ENUM_TIMEFRAMES 型を使うと、MetaTraderのパラメーター設定画面でドロップダウンリストから時間足を選択できるようになります。これは非常に便利なテクニックです。

input ENUM_TIMEFRAMES InpTimeframe = PERIOD_H1; // 分析する時間足
input int             InpMAPeriod  = 20;         // 移動平均線の期間

void OnTick()
{
    double ma = iMA(NULL, InpTimeframe, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
    // ユーザーが選択した時間足のMAを使って売買判断
}

ユーザーが数値を手入力する必要がなく、選択ミスも防げるので、EA配布時にも親切な設計になります。

PeriodSeconds()で時間足を秒数に変換する

// 現在の時間足の1本あたりの秒数を取得
int seconds = PeriodSeconds(PERIOD_H1);
Print("1時間足の1本 = ", seconds, "秒"); // 3600秒

// 引数を省略すると現在のチャートの時間足が使われる
int current_seconds = PeriodSeconds();

時間計算を行う場面（例：「次のバーが生成されるまで何秒か」など）で非常に役立ちます。

マルチタイムフレーム分析のEAサンプル

実践的な例として、日足のトレンド方向を確認してからエントリーする簡易EAのロジックを紹介します。

input ENUM_TIMEFRAMES InpEntryTF  = PERIOD_H1;  // エントリー判断の時間足
input ENUM_TIMEFRAMES InpFilterTF = PERIOD_D1;  // トレンドフィルターの時間足
input int             InpMAPeriod = 20;          // MA期間

void OnTick()
{
    // 上位足（日足）のMAでトレンド方向を判定
    double ma_filter = iMA(NULL, InpFilterTF, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
    double price_filter = iClose(NULL, InpFilterTF, 0);
    
    bool uptrend   = (price_filter > ma_filter);
    bool downtrend = (price_filter < ma_filter);
    
    // エントリー足のMAでエントリーシグナルを判定
    double ma_entry = iMA(NULL, InpEntryTF, InpMAPeriod, 0, MODE_SMA, PRICE_CLOSE, 0);
    double price_entry = iClose(NULL, InpEntryTF, 0);
    
    // 日足が上昇トレンド かつ 1時間足で価格がMAを上抜け → 買いシグナル
    if(uptrend && price_entry > ma_entry)
    {
        // 買い注文のロジック
        Print("買いシグナル検出！");
    }
    
    // 日足が下降トレンド かつ 1時間足で価格がMAを下抜け → 売りシグナル
    if(downtrend && price_entry < ma_entry)
    {
        // 売り注文のロジック
        Print("売りシグナル検出！");
    }
}

このように、時間足定数を活用すればマルチタイムフレーム分析のロジックを簡潔に書くことができます。

よくある注意点・トラブル

整数値の直書きは避ける

以下のように整数値を直接書くのは避けましょう。

// ❌ 悪い例：何を意味しているのかわかりにくい
double ma = iMA(NULL, 60, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

// ✅ 良い例：PERIOD_H1と書けば一目で1時間足とわかる
double ma = iMA(NULL, PERIOD_H1, 20, 0, MODE_SMA, PRICE_CLOSE, 0);

可読性が下がるだけでなく、MQL5へ移植する際にバグの原因になります。

ヒストリーデータ不足に注意

別の時間足のデータを参照するとき、MetaTraderにその時間足のヒストリーデータが十分にダウンロードされていない場合があります。特にバックテスト時に、上位足のデータが不足していると正しい結果が得られません。

必要な時間足のチャートを一度開いてデータを読み込ませるか、スクリプトで事前にデータの存在を確認する処理を入れておくと安心です。

PERIOD_CURRENTと0の違い

PERIOD_CURRENT の整数値は 0 です。関数に 0 を渡しても PERIOD_CURRENT を渡しても同じ動作になりますが、コードの意図を明確にするために PERIOD_CURRENT を使うことをおすすめします。

まとめ

MQL4の時間足定数（ENUM_TIMEFRAMES）について、重要なポイントを整理します。

• PERIOD_M1〜PERIOD_MN1の9つの時間足定数と、PERIOD_CURRENT（現在のチャートの時間足）が使える
• MQL4の整数値は「分」が基準（H1=60, D1=1440など）
• MQL5ではH1以上の整数値が全く異なるため、移植時は必ず定数名を使う
• input ENUM_TIMEFRAMES でパラメーター化すると、ドロップダウン選択が自動生成されて便利
• PeriodSeconds() で時間足を秒数に変換でき、時間計算に活用できる
• マルチタイムフレーム分析では、上位足のデータ（ヒストリー）が十分にあるか確認が必要

時間足定数はEA開発で日常的に使う基本中の基本です。まずは iMA() や iClose() に異なる時間足を指定するところから試してみてください。マルチタイムフレーム分析ができるようになると、EA戦略の幅が大きく広がりますよ！

投稿 【MQL4】時間足定数（ENUM_TIMEFRAMES）完全ガイド｜PERIOD_M1〜PERIOD_MN1の一覧と実践的な使い方 は 自動売買を作ろう！ に最初に表示されました。

この記事では、ターミナルグローバル変数を操作するための主要関数 ── GlobalVariableSet、GlobalVariableGet、GlobalVariableCheck、GlobalVariableDel を中心に、使い方と注意点をわかりやすく解説します。

ターミナルグローバル変数とは？── 2種類の「グローバル変数」に注意

MQL4には「グローバル変数」と呼ばれるものが2種類あります。ここを混同すると大きな混乱のもとになるので、最初にしっかり区別しましょう。

① MQL4プログラム内のグローバル変数

関数の外（OnInit()やOnTick()の外側）で宣言する変数のことです。プログラム全体からアクセスできますが、EAをチャートから外したりMT4を終了すると値は消えます。

// プログラム内グローバル変数の例
int g_tickCount = 0;  // プログラム内のどの関数からもアクセス可能

void OnTick()
{
    g_tickCount++;
    Print("ティック回数: ", g_tickCount);
}

② クライアントターミナルのグローバル変数（本記事の主役）

MT4のメニュー「ツール → グローバル変数」（ショートカット：F3キー）で確認できる変数です。こちらはMT4を終了してもデータが保持されます。さらに、同じMT4上で動作しているすべてのEA・インジケーターからアクセス可能なので、プログラム間のデータ共有にも使えます。

ターミナルグローバル変数の特徴をまとめると、次のとおりです。

• データ型は double 型のみ（文字列や整数を直接格納することはできません）
• 最後のアクセスから4週間保持され、その後は自動的に削除される
• 同一MT4上の全MQL4プログラムからアクセス可能
• GlobalVariable系の専用関数を使って操作する

主要なグローバル変数関数一覧

以下が、ターミナルグローバル変数を操作するための主要関数です。

この中でも特に使用頻度の高い4つの関数を、コード例とともに詳しく見ていきましょう。

GlobalVariableSet() ── 値の設定・新規作成

ターミナルグローバル変数に値を設定する関数です。指定した名前の変数が存在しない場合は、自動的に新しい変数が作成されます。

// 構文
datetime GlobalVariableSet(
    string name,   // グローバル変数名
    double value   // 設定する値
);

戻り値は、成功した場合に最終アクセス時刻（datetime型）、失敗した場合に0が返ります。

void OnInit()
{
    // グローバル変数 "MyEA_BuyPrice" に値を設定
    datetime dt = GlobalVariableSet("MyEA_BuyPrice", 150.250);
    
    if(dt != 0)
        Print("設定成功！ アクセス時刻: ", TimeToString(dt));
    else
        Print("設定失敗。エラー: ", GetLastError());
}

GlobalVariableGet() ── 値の取得

ターミナルグローバル変数から値を読み取る関数です。戻り値はdouble型です。

// 構文
double GlobalVariableGet(
    string name   // グローバル変数名
);

指定した名前の変数が存在しない場合は0が返り、エラーコードがセットされます。

void OnTick()
{
    double buyPrice = GlobalVariableGet("MyEA_BuyPrice");
    
    if(GetLastError() == 0)
        Print("保存されていた買値: ", buyPrice);
    else
        Print("グローバル変数が見つかりません");
}

💡 ポイント：戻り値が0なのか、それとも「本当に0が格納されている」のか区別がつかない場合があります。確実に存在を確認したい場合は、次に紹介する GlobalVariableCheck() と組み合わせましょう。

GlobalVariableCheck() ── 存在の確認

指定した名前のターミナルグローバル変数が存在するかどうかを確認する関数です。

// 構文
bool GlobalVariableCheck(
    string name   // グローバル変数名
);

変数が存在する場合は true、存在しない場合は false を返します。

void OnInit()
{
    string gvName = "MyEA_BuyPrice";
    
    // 変数が存在するか先に確認してから値を取得する
    if(GlobalVariableCheck(gvName))
    {
        double val = GlobalVariableGet(gvName);
        Print(gvName, " の値: ", val);
    }
    else
    {
        Print(gvName, " は存在しません。初期値を設定します。");
        GlobalVariableSet(gvName, 0.0);
    }
}

このように、GlobalVariableCheck() → GlobalVariableGet() の順で呼び出すのが安全なパターンです。

GlobalVariableDel() ── 変数の削除

不要になったターミナルグローバル変数を削除する関数です。

// 構文
bool GlobalVariableDel(
    string name   // グローバル変数名
);

削除に成功した場合は true、失敗した場合は false を返します。

void OnDeinit(const int reason)
{
    // EA終了時にグローバル変数をクリーンアップ
    if(GlobalVariableDel("MyEA_BuyPrice"))
        Print("グローバル変数を削除しました");
    else
        Print("削除失敗。エラー: ", GetLastError());
}

実践例：EA再起動後もポジション情報を保持する

ここまでの関数を組み合わせた実践的なサンプルを見てみましょう。EAがポジションを持ったときにチケット番号をターミナルグローバル変数に保存し、MT4再起動後でも管理を継続できるようにします。

#property strict

// EA固有のプレフィックスをつけて名前衝突を防ぐ
string gvPrefix = "SampleEA_";

//+------------------------------------------------------------------+
//| 初期化処理                                                        |
//+------------------------------------------------------------------+
void OnInit()
{
    string gvTicket = gvPrefix + Symbol() + "_Ticket";
    
    // 前回保存したチケット番号があるか確認
    if(GlobalVariableCheck(gvTicket))
    {
        int ticket = (int)GlobalVariableGet(gvTicket);
        if(ticket > 0)
        {
            Print("前回のチケット番号を復元: ", ticket);
            // 必要に応じてポジション情報を再取得する処理を追加
        }
    }
    else
    {
        Print("保存済みチケットなし。新規稼働を開始します。");
    }
}

//+------------------------------------------------------------------+
//| ティック処理                                                      |
//+------------------------------------------------------------------+
void OnTick()
{
    string gvTicket = gvPrefix + Symbol() + "_Ticket";
    
    // 新規注文を出す処理（簡略化）
    int ticket = OrderSend(Symbol(), OP_BUY, 0.01, Ask, 3, 0, 0, "SampleEA", 12345, 0, clrBlue);
    
    if(ticket > 0)
    {
        // チケット番号をグローバル変数に保存
        GlobalVariableSet(gvTicket, (double)ticket);
        Print("チケット ", ticket, " をグローバル変数に保存しました");
    }
}

//+------------------------------------------------------------------+
//| 終了処理                                                          |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
    // パラメータ変更やチャート切替時はデータを保持
    // 手動削除(REASON_REMOVE)の場合のみクリーンアップ
    if(reason == REASON_REMOVE)
    {
        string gvTicket = gvPrefix + Symbol() + "_Ticket";
        GlobalVariableDel(gvTicket);
        Print("EA削除のため、グローバル変数をクリーンアップしました");
    }
}

グローバル変数を使うときの注意点

1. 名前の衝突に注意 ── プレフィックスをつけよう

ターミナルグローバル変数は同じMT4上の全プログラムで共有されます。異なるEAが同じ名前の変数を使うと、互いに値を上書きしてしまい不具合の原因になります。上のサンプルのように、EA名＋通貨ペア名をプレフィックスとしてつけるのがベストプラクティスです。

2. 格納できるのは double 型のみ

ターミナルグローバル変数に格納できるのはdouble型の値だけです。整数（int）を保存したい場合はキャストが必要です。また、long型の大きな値（例：チャートIDなど）を格納すると、doubleの精度の問題で値が正確に復元できないことがあるので注意が必要です。

3. 4週間でデータが消える

クライアントターミナルのグローバル変数は、最後のアクセスから4週間クライアントターミナルに保持され、その後自動的に削除されます。長期間EAを停止する場合は、この点を意識しておきましょう。定期的にアクセス（読み書き）すればタイマーはリセットされます。

4. 不要な変数は削除する

使わなくなったグローバル変数を放置すると、F3キーで確認したときに一覧が煩雑になります。EA終了時に適切に GlobalVariableDel() で削除するか、GlobalVariablesDeleteAll() でプレフィックス指定の一括削除を行いましょう。

// プレフィックスを指定して一括削除
int deleted = GlobalVariablesDeleteAll("SampleEA_");
Print(deleted, " 個のグローバル変数を削除しました");

補足：その他の便利な関数

主要4関数以外にも、覚えておくと便利な関数を紹介します。

• GlobalVariablesTotal() ── 現在のターミナルグローバル変数の総数を取得
• GlobalVariableName(index) ── インデックス番号から変数名を取得（ループで全変数を列挙する際に便利）
• GlobalVariableSetOnCondition() ── 現在値が指定値と一致する場合のみ更新する（排他制御に利用可能）
• GlobalVariableTemp() ── MT4終了時に自動削除される一時的なグローバル変数を作成
• GlobalVariablesFlush() ── メモリ上のグローバル変数をディスクに強制保存

まとめ

ターミナルグローバル変数は、MQL4プログラミングにおいてデータの永続化やプログラム間のデータ共有を実現するための重要な仕組みです。今回紹介した4つの基本関数を押さえておけば、多くの場面で活用できます。

• GlobalVariableSet() で値を保存
• GlobalVariableGet() で値を取得
• GlobalVariableCheck() で存在を確認
• GlobalVariableDel() で不要な変数を削除

名前の衝突を避けるためにプレフィックスをつけること、double型しか格納できないこと、4週間の有効期限があることを忘れずに、安全で堅牢なEA開発に役立ててください！

**記事のポイント：**

| 項目 | 内容 |

|—|—|

| **タイトル** | 【MQL4】グローバル変数関数の使い方を徹底解説！GlobalVariableSet / Get / Check / Del |

| **タグ** | MQL4, グローバル変数, GlobalVariableSet, EA開発, MetaTrader4 |

| **文字数** | 約8,900文字（HTML含む） / 本文テキスト約3,000文字相当 |

| **構成** | 導入 → 2種類のグローバル変数の区別 → 関数一覧表 → 4関数の詳細解説（構文＋コード例） → 実践サンプル → 注意点4つ → 補足関数 → まとめ |

記事の特徴：

– **初心者が最も混同しやすい「2種類のグローバル変数」の違い**を冒頭で明確に解説

– 各関数に**構文・戻り値・実用コードサンプル**を掲載

– **実践例**として「EA再起動後もチケット番号を保持する」リアルなユースケースを提示

– **注意点**では名前衝突・double型制限・4週間有効期限・long型精度問題など、実開発で陥りやすい落とし穴をカバー

– 補足として `GlobalVariableSetOnCondition` や `GlobalVariableTemp` など発展的な関数も紹介

投稿 【MQL4】グローバル変数関数の使い方を徹底解説！GlobalVariableSet / Get / Check / Del は 自動売買を作ろう！ に最初に表示されました。

今回は、EA開発で特に使用頻度が高い以下の6つのユーティリティ関数をまとめて解説します。

• Sleep() — 処理の一時停止
• RefreshRates() — 価格データの最新化
• IsTradeAllowed() — 自動売買の許可状態を確認
• IsConnected() — サーバー接続の確認
• IsTesting() — バックテスト中かどうかの判定
• IsOptimization() — 最適化モードかどうかの判定

それぞれの基本的な使い方から、最後に6つすべてを組み合わせた実践テンプレートまで紹介しますので、ぜひ最後までお読みください。

Sleep() — ミリ秒単位で処理を一時停止する

基本構文

void Sleep(int milliseconds);

Sleep()は、指定したミリ秒（1000ミリ秒＝1秒）だけEAの処理を一時停止する関数です。注文のリトライ処理やサーバーとの通信待ちなどで頻繁に使われます。

使用例：注文失敗時のリトライ

注文送信が失敗した場合、少し間をおいてからリトライするのが一般的なパターンです。

int ticket = -1;
int retryCount = 3;

for(int i = 0; i < retryCount; i++)
{
    ticket = OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0, "Buy Order", 0, 0, clrBlue);

    if(ticket > 0)
    {
        Print("注文成功！ チケット番号: ", ticket);
        break;
    }
    else
    {
        int err = GetLastError();
        Print("注文失敗（", i + 1, "回目） エラー: ", err);
        Sleep(1000);  // 1秒待ってからリトライ
    }
}

Sleep()の注意点

• ストラテジーテスターでは無視されます。バックテスト中にSleep()を呼んでも、実際には一時停止しません。テスト速度に影響を与えないための仕様です。
• Sleep()の内部では約0.1秒ごとにEAの停止フラグがチェックされています。そのため、Sleep(10000)（10秒停止）を実行中でも、ユーザーがEAを停止すれば比較的すぐに処理が終了します。
• カスタムインジケーターの中では使用できません。EAおよびスクリプト専用の関数です。

RefreshRates() — 価格データを最新の状態に更新する

基本構文

bool RefreshRates();

RefreshRates()は、Bid、Ask、Volumeなどの定義済み変数を最新のサーバーデータに更新する関数です。更新に成功するとtrueを返します。

なぜRefreshRates()が必要なのか

EAのOnTick()が呼び出された瞬間に、BidやAskには最新の値がセットされます。しかし、その後にSleep()で待機したり、重い計算処理を行ったりすると、BidやAskの値が古くなってしまう可能性があります。

つまり、Sleep()の後にはRefreshRates()を呼ぶのが鉄則です。

使用例：Sleep()とRefreshRates()のセット

// 注文失敗 → 待機 → 価格を更新してリトライ
Sleep(1000);
RefreshRates();  // Bid/Askを最新に更新

// 更新後のAskで再度注文
ticket = OrderSend(Symbol(), OP_BUY, 0.1, Ask, 3, 0, 0, "Retry Order", 0, 0, clrBlue);

RefreshRates()を呼ばずに古いAsk値で注文を出すと、「Off quotes（無効な価格）」エラーが発生する原因になります。注意しましょう。

IsTradeAllowed() — 自動売買が許可されているか確認する

基本構文

bool IsTradeAllowed();

IsTradeAllowed()は、EAによる自動売買が許可されている場合にtrueを返す関数です。具体的には、以下の2つの条件を確認しています。

• MetaTraderのツールバーにある「自動売買」ボタンがONになっているか
• 他のEAやスクリプトが取引コンテキストを使用中（ビジー状態）でないか

使用例：注文前の安全チェック

void OnTick()
{
    // 自動売買が許可されていなければ何もしない
    if(!IsTradeAllowed())
    {
        Print("自動売買が無効です。ツールバーの自動売買ボタンを確認してください。");
        return;
    }

    // ここから注文ロジック
    // ...
}

取引コンテキストのビジー状態に対処する

同一のMetaTrader上で複数のEAが動作している場合、1つのEAが注文処理を行っている間は他のEAの取引がブロックされます。このような場合は、少し待ってから再確認するのが有効です。

// 取引コンテキストが空くまで待機（最大5秒）
for(int i = 0; i < 10; i++)
{
    if(IsTradeAllowed())
        break;

    Print("取引コンテキストがビジー状態です。待機中...");
    Sleep(500);
}

IsConnected() — サーバーとの接続状態を確認する

基本構文

bool IsConnected();

IsConnected()は、MetaTraderクライアントがブローカーのサーバーと接続されている場合にtrueを返す関数です。

使用例：接続チェック

void OnTick()
{
    if(!IsConnected())
    {
        Print("サーバーに接続されていません！ 注文処理をスキップします。");
        return;
    }

    // 接続確認OK → 通常の処理へ
}

VPS運用時に特に重要

VPS（仮想専用サーバー）でEAを24時間稼働させている場合、ネットワークの一時的な切断は避けられません。IsConnected()で接続状態をチェックし、切断時にはアラートを出すなどの処理を組み込んでおくと安心です。

static datetime lastAlertTime = 0;

if(!IsConnected())
{
    // 5分に1回だけアラート
    if(TimeCurrent() - lastAlertTime > 300)
    {
        Alert("サーバー接続が切断されています！");
        lastAlertTime = TimeCurrent();
    }
    return;
}

IsTesting() — バックテスト中かどうかを判定する

基本構文

bool IsTesting();

IsTesting()は、EAがストラテジーテスター上で動作しているときにtrueを返す関数です。ライブ口座やデモ口座で動かしている場合はfalseになります。

使用例：テスト時にGUI処理をスキップして高速化

バックテスト（特にビジュアルモードではない通常テスト）では、画面への描画処理は不要です。Comment()やObjectCreate()といった描画関数をスキップすることで、テスト速度を大幅に向上できます。

// グローバル変数としてフラグを用意
bool gIsTesting = false;

int OnInit()
{
    // init()内で1度だけ判定すれば十分
    gIsTesting = IsTesting();
    return(INIT_SUCCEEDED);
}

void OnTick()
{
    // テスト中でなければ画面に情報を表示
    if(!gIsTesting)
    {
        Comment("Bid: ", Bid, "  Ask: ", Ask, "  Spread: ", MarketInfo(Symbol(), MODE_SPREAD));
    }

    // 売買ロジック...
}

ポイント：IsTesting()の戻り値はEAの実行中に変わることはありません。そのため、OnInit()内で一度だけ判定してグローバル変数に保存すれば十分です。OnTick()のたびに呼び出す必要はなく、わずかですがパフォーマンスの改善につながります。

IsOptimization() — 最適化モードかどうかを判定する

基本構文

bool IsOptimization();

IsOptimization()は、ストラテジーテスターの最適化モードで実行されているときにtrueを返す関数です。最適化モードでは、パラメータの組み合わせを大量にテストするため、不要な処理を極力省くことが重要になります。

使用例：最適化中はPrint()を抑制する

最適化モードでは、Print()による出力がログに記録されません。つまり、Print()を呼んでもデバッグの役に立たないだけでなく、処理のオーバーヘッドだけが残ります。

bool gIsOptimization = false;

int OnInit()
{
    gIsOptimization = IsOptimization();
    return(INIT_SUCCEEDED);
}

void OnTick()
{
    // 最適化中はデバッグ出力をスキップ
    if(!gIsOptimization)
    {
        Print("現在のBid: ", Bid, " Ask: ", Ask);
    }

    // 売買ロジック...
}

IsTesting()との使い分け

IsTesting()とIsOptimization()の関係を整理しておきましょう。

最適化モードのときはIsTesting()もtrueになります。つまり「IsTesting()がtrueかつIsOptimization()がfalse」であれば通常のバックテスト、「両方ともtrue」であれば最適化中ということになります。

実践テンプレート：6つの関数を組み合わせた安全な注文処理

ここまで紹介した6つの関数をすべて組み合わせた、実践的な注文処理テンプレートを紹介します。実際のEA開発でそのまま活用できる構成です。

//--- グローバル変数
bool gIsTesting      = false;
bool gIsOptimization = false;

//+------------------------------------------------------------------+
//| 初期化関数                                                         |
//+------------------------------------------------------------------+
int OnInit()
{
    // 実行環境フラグを初期化時に1度だけ判定
    gIsTesting      = IsTesting();
    gIsOptimization = IsOptimization();

    if(!gIsOptimization)
        Print("EA初期化完了 テストモード: ", gIsTesting);

    return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| 安全な買い注文関数                                                  |
//+------------------------------------------------------------------+
int SafeBuyOrder(double lots, int slippage, double sl, double tp, string comment)
{
    int maxRetry = 3;
    int ticket   = -1;

    //--- 1. サーバー接続チェック（テスト時はスキップ）
    if(!gIsTesting && !IsConnected())
    {
        Print("エラー: サーバーに接続されていません");
        return(-1);
    }

    //--- 2. 自動売買許可チェック
    if(!IsTradeAllowed())
    {
        Print("エラー: 自動売買が許可されていません");
        return(-1);
    }

    //--- 3. リトライループ
    for(int i = 0; i < maxRetry; i++)
    {
        // 価格データを最新に更新
        RefreshRates();

        // 注文送信
        ticket = OrderSend(Symbol(), OP_BUY, lots, Ask, slippage, sl, tp, comment, 0, 0, clrBlue);

        if(ticket > 0)
        {
            if(!gIsOptimization)
                Print("買い注文成功！ チケット: ", ticket, " 価格: ", Ask);
            break;
        }
        else
        {
            int err = GetLastError();
            if(!gIsOptimization)
                Print("買い注文失敗（", i + 1, "/", maxRetry, "） エラーコード: ", err);

            // 最後のリトライでなければ待機
            if(i < maxRetry - 1)
            {
                Sleep(1000);  // 1秒待機（テスターでは無視される）
            }
        }
    }

    return(ticket);
}

//+------------------------------------------------------------------+
//| ティックごとの処理                                                  |
//+------------------------------------------------------------------+
void OnTick()
{
    //--- 画面表示（通常バックテスト・最適化時はスキップ）
    if(!gIsTesting)
    {
        Comment("EA稼働中 | Bid: ", Bid, " | Ask: ", Ask,
                " | 接続: ", (IsConnected() ? "OK" : "NG"),
                " | 自動売買: ", (IsTradeAllowed() ? "許可" : "不可"));
    }

    //--- ここに売買条件を記述 ---
    // 例: 買い条件を満たしたら注文
    // int ticket = SafeBuyOrder(0.1, 3, 0, 0, "Sample EA");
}

//+------------------------------------------------------------------+
//| 終了処理                                                          |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
    if(!gIsOptimization)
        Print("EA停止 理由コード: ", reason);

    // テスト時でなければコメントをクリア
    if(!gIsTesting)
        Comment("");
}

このテンプレートでは、以下のポイントを押さえています。

• OnInit()で環境フラグを一度だけ判定 — IsTesting()やIsOptimization()を毎ティック呼ぶ無駄を排除
• 注文前にIsConnected()とIsTradeAllowed()をチェック — 接続切れや自動売買無効時のエラーを未然に防止
• リトライ時にSleep() + RefreshRates()をセットで使用 — 待機後に最新価格を取得してから再注文
• 最適化中はPrint()をスキップ — 不要な処理のオーバーヘッドを削減
• テスト中はComment()による画面描画をスキップ — バックテストの高速化

まとめ

今回紹介した6つのユーティリティ関数を一覧表で振り返りましょう。

これらの関数は単体で使うだけでなく、組み合わせて使うことで真価を発揮します。特に「Sleep() → RefreshRates()」のセットや、「IsTesting() / IsOptimization()による処理の出し分け」は、EA開発における定番テクニックです。

今回紹介した実践テンプレートをベースに、ご自身のEAに安全で効率的な処理を組み込んでみてください。堅牢なEAを作る第一歩になるはずです。

投稿 【MQL4】知っておきたいユーティリティ関数6選！Sleep・RefreshRates・IsTradeAllowed・IsConnected・IsTesting・IsOptimizationの使い方 は 自動売買を作ろう！ に最初に表示されました。

この記事では、MarketInfo関数と、より新しいSymbolInfoDouble・SymbolInfoInteger・SymbolInfoString関数の使い方を、実践的なコード例とともに徹底解説します。

MarketInfo関数 ― MQL4の基本

MarketInfo関数は、気配値表示ウィンドウに表示されている通貨ペアのマーケット情報を取得するための、MQL4で最も古くから使われている関数です。

基本構文

double MarketInfo(string symbol, int type);

第1引数に通貨ペア名（例：”USDJPY”）、第2引数にMODE定数を指定します。戻り値はすべてdouble型です。

主なMODE定数一覧

基本的な使用例

void OnStart()
{
    string sym = Symbol(); // 現在のチャートの通貨ペア

    double bid       = MarketInfo(sym, MODE_BID);
    double ask       = MarketInfo(sym, MODE_ASK);
    double spread    = MarketInfo(sym, MODE_SPREAD);
    double stopLevel = MarketInfo(sym, MODE_STOPLEVEL);
    double tickValue = MarketInfo(sym, MODE_TICKVALUE);
    double minLot    = MarketInfo(sym, MODE_MINLOT);

    PrintFormat("Bid=%.5f  Ask=%.5f  Spread=%.0f  StopLevel=%.0f",
                bid, ask, spread, stopLevel);
    PrintFormat("TickValue=%.5f  MinLot=%.2f", tickValue, minLot);
}

MarketInfo関数はシンプルで使いやすいですが、戻り値がすべてdouble型のため、本来は整数値であるスプレッドや桁数もdoubleで返ってきます。キャストが必要になる場面がある点は覚えておきましょう。

SymbolInfo系関数 ― より型安全な新しい方法

MQL4のビルド600以降では、MarketInfoの代替としてSymbolInfo系関数が使えるようになりました。これらはMQL5と共通の関数であり、将来的なMQL5移行を見据えるなら、こちらを使うのがおすすめです。

SymbolInfo系関数は、取得するデータの型に応じて3つに分かれています。

SymbolInfoDouble ― double型の市場情報を取得

SymbolInfoDoubleには2つの書式があります。

書式1：戻り値で直接受け取る

double SymbolInfoDouble(string symbol, ENUM_SYMBOL_INFO_DOUBLE prop_id);

書式2：参照引数で受け取る（成否判定付き）

bool SymbolInfoDouble(string symbol, ENUM_SYMBOL_INFO_DOUBLE prop_id, double &value);

書式2はboolを返すため、取得が成功したかどうかを判定できます。安全なコードを書きたい場合はこちらを推奨します。

主なプロパティID

コード例

void OnStart()
{
    string sym = Symbol();

    // 書式1：直接取得
    double bid = SymbolInfoDouble(sym, SYMBOL_BID);
    double ask = SymbolInfoDouble(sym, SYMBOL_ASK);
    PrintFormat("Bid=%.5f  Ask=%.5f", bid, ask);

    // 書式2：成否判定付き
    double tickValue;
    if(SymbolInfoDouble(sym, SYMBOL_TRADE_TICK_VALUE, tickValue))
        PrintFormat("TickValue = %.5f", tickValue);
    else
        Print("TickValue の取得に失敗しました");
}

SymbolInfoInteger ― 整数型の市場情報を取得

スプレッドや桁数など、整数で扱うべき情報をlong型で返します。MarketInfoではdoubleで返っていたものが正しい型で取得できるようになりました。

主なプロパティID

void OnStart()
{
    string sym = Symbol();

    long spread    = SymbolInfoInteger(sym, SYMBOL_SPREAD);
    long digits    = SymbolInfoInteger(sym, SYMBOL_DIGITS);
    long stopLevel = SymbolInfoInteger(sym, SYMBOL_TRADE_STOPS_LEVEL);

    PrintFormat("Spread=%d  Digits=%d  StopLevel=%d",
                (int)spread, (int)digits, (int)stopLevel);
}

SymbolInfoString ― 文字列型の市場情報を取得

通貨ペアの基軸通貨や決済通貨、説明文などの文字列情報を取得します。

void OnStart()
{
    string sym = Symbol();

    string baseCurrency   = SymbolInfoString(sym, SYMBOL_CURRENCY_BASE);
    string profitCurrency = SymbolInfoString(sym, SYMBOL_CURRENCY_PROFIT);
    string description    = SymbolInfoString(sym, SYMBOL_DESCRIPTION);

    PrintFormat("基軸通貨=%s  決済通貨=%s", baseCurrency, profitCurrency);
    PrintFormat("説明: %s", description);
}

MarketInfo と SymbolInfo系の対応関係

既存のコードをSymbolInfo系に書き換えたいときは、以下の対応表を参考にしてください。

実践テクニック

①スプレッドフィルター

スプレッドが広がっているときにエントリーを避ける、シンプルなフィルターです。

// スプレッドが指定pips以上なら取引しない
bool IsSpreadOK(int maxSpreadPoints)
{
    long spread = SymbolInfoInteger(Symbol(), SYMBOL_SPREAD);
    if(spread > maxSpreadPoints)
    {
        PrintFormat("スプレッドが広すぎます: %d > %d", (int)spread, maxSpreadPoints);
        return false;
    }
    return true;
}

②ストップレベルを考慮したSL/TP設定

ブローカーによってはストップレベルが設定されており、現在価格から一定以上離れていないとSL/TPを設定できません。また、ストップレベルが0を返す場合でも実際にはサーバー側で制限がかかるケースがあるため、最低限のマージンを確保するのがポイントです。

double GetSafeStopDistance()
{
    long   stopLevel = SymbolInfoInteger(Symbol(), SYMBOL_TRADE_STOPS_LEVEL);
    double point     = SymbolInfoDouble(Symbol(), SYMBOL_POINT);

    // ストップレベルが0の場合でも最低10ポイントは確保
    if(stopLevel < 10)
        stopLevel = 10;

    return stopLevel * point;
}

// 使用例：Buy注文のSL/TPを安全に設定
double safeDistance = GetSafeStopDistance();
double sl = Ask - MathMax(desiredSL, safeDistance);
double tp = Ask + MathMax(desiredTP, safeDistance);

③リスクベースのロット計算

口座残高の一定割合をリスクとして、適切なロット数を計算する関数です。

double CalcLotSize(double riskPercent, double slPoints)
{
    string sym = Symbol();

    double balance   = AccountBalance();
    double riskMoney = balance * riskPercent / 100.0;

    double tickValue = SymbolInfoDouble(sym, SYMBOL_TRADE_TICK_VALUE);
    double tickSize  = SymbolInfoDouble(sym, SYMBOL_TRADE_TICK_SIZE);
    double point     = SymbolInfoDouble(sym, SYMBOL_POINT);
    double minLot    = SymbolInfoDouble(sym, SYMBOL_VOLUME_MIN);
    double maxLot    = SymbolInfoDouble(sym, SYMBOL_VOLUME_MAX);
    double lotStep   = SymbolInfoDouble(sym, SYMBOL_VOLUME_STEP);

    if(tickValue == 0 || tickSize == 0) return minLot;

    // 1ポイントあたりの価値
    double pointValue = tickValue * (point / tickSize);

    // ロット計算
    double lots = riskMoney / (slPoints * pointValue);

    // ロットステップに丸める
    lots = MathFloor(lots / lotStep) * lotStep;

    // 最小・最大ロットでクランプ
    lots = MathMax(lots, minLot);
    lots = MathMin(lots, maxLot);

    return NormalizeDouble(lots, 2);
}

ストラテジーテスターでの注意点

ストラテジーテスター（バックテスト）では、市場情報の取得に制限があります。

• 他の通貨ペアの情報：テスト対象以外の通貨ペアのMarketInfoやSymbolInfoは、正しい値が返らないことがあります
• TickValueが0になる：テスト開始直後やクロス通貨ペアで、SYMBOL_TRADE_TICK_VALUEが0を返す場合があります
• 対処法：TickValueが0の場合はデフォルト値を使う、またはOnTick()内で値が有効になるまで待つ処理を入れましょう

// テスター対策：TickValueが0なら処理をスキップ
void OnTick()
{
    double tickValue = SymbolInfoDouble(Symbol(), SYMBOL_TRADE_TICK_VALUE);
    if(tickValue <= 0)
    {
        Print("TickValueが無効です。次のティックを待ちます。");
        return;
    }

    // 通常のEAロジック
    // ...
}

まとめ

最後に、この記事のポイントを整理します。

1. MarketInfo関数はMQL4の基本関数で、MODE定数を使って様々な市場情報をdouble型で取得できる
2. SymbolInfo系関数（Double/Integer/String）はデータ型に応じた3つの関数に分かれており、型安全に情報を取得できる
3. MQL5への移行を見据えるなら、SymbolInfo系関数を使う習慣をつけるのがおすすめ
4. ストップレベルは0を返す場合でも最低限のマージンを確保すると安全
5. TickValueを使ったロット計算は実践的なEAに不可欠
6. ストラテジーテスターでは他通貨ペア情報やTickValueが正しく取得できない場合があるため、ガード処理を入れておくことが大切

これらの関数を使いこなせるようになると、ブローカーの取引条件に応じた柔軟なEAが作れるようになります。ぜひ実際にコードを書いて、各関数の返り値を確認してみてください！

投稿 【MQL4】市場情報を取得する関数を完全解説！MarketInfo・SymbolInfoDouble・SymbolInfoInteger・SymbolInfoStringの使い方 は 自動売買を作ろう！ に最初に表示されました。

この記事では、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の使い方を徹底解説 は 自動売買を作ろう！ に最初に表示されました。

この記事では、MQL4で特に使用頻度の高い6つの配列関数を体系的に解説します。

• ArraySize() – 要素数の取得
• ArrayResize() – サイズの動的変更
• ArrayInitialize() – 全要素の一括初期化
• ArrayCopy() – 配列のコピー
• ArraySort() – ソート（並び替え）
• ArraySetAsSeries() – 時系列インデックスへの変換

それぞれの関数について、基本的な使い方・注意点・実践的なコードサンプルを交えながら丁寧に解説していきます。

ArraySize() – 配列の要素数を取得する

ArraySize()は、配列に含まれる全要素数を返す関数です。ループ処理で配列の全要素を走査するときに欠かせません。

基本構文

int ArraySize(
   const void& array[]   // 対象の配列
);

基本的な使い方

void OnStart()
{
   double prices[5] = {100.0, 101.5, 102.3, 99.8, 100.7};

   int size = ArraySize(prices);
   Print("要素数: ", size);  // 出力: 要素数: 5

   // ループ処理での活用
   for(int i = 0; i < ArraySize(prices); i++)
   {
      Print("prices[", i, "] = ", prices[i]);
   }
}

多次元配列での注意点

ArraySize()は多次元配列に対しては、全次元の要素数の積（全要素数）を返します。特定の次元の要素数だけを知りたい場合はArrayRange()を使いましょう。

void OnStart()
{
   double matrix[3][4];  // 3行4列の二次元配列

   Print("ArraySize: ", ArraySize(matrix));       // 出力: 12（3×4）
   Print("第1次元: ", ArrayRange(matrix, 0));      // 出力: 3
   Print("第2次元: ", ArrayRange(matrix, 1));      // 出力: 4
}

ArrayResize() – 配列のサイズを動的に変更する

ArrayResize()は、動的配列のサイズを変更する関数です。EAの運用中にデータが増減する場面で大活躍します。

基本構文

int ArrayResize(
   void& array[],         // サイズ変更する配列
   int    new_size,        // 新しいサイズ
   int    reserve_size=0   // 予約サイズ（省略可）
);

戻り値は、成功した場合は新しいサイズ、失敗した場合は-1です。

基本的な使い方

void OnStart()
{
   double data[];  // 動的配列（サイズ未指定）

   // サイズを5に設定
   ArrayResize(data, 5);
   Print("サイズ: ", ArraySize(data));  // 出力: 5

   // データを格納
   for(int i = 0; i < 5; i++)
      data[i] = i * 1.5;

   // サイズを10に拡張（既存データは保持される）
   ArrayResize(data, 10);
   Print("拡張後サイズ: ", ArraySize(data));  // 出力: 10
   Print("data[2] = ", data[2]);  // 出力: 3.0（既存データは保持）
}

reserve_sizeでパフォーマンスを改善する

ループ内で何度もArrayResize()を呼ぶと、メモリの再割り当てが頻繁に発生しパフォーマンスが低下します。第3引数のreserve_sizeを指定することで、あらかじめメモリを多めに確保し、再割り当ての回数を減らせます。

void OnStart()
{
   double ticks[];
   int count = 0;

   // 悪い例：毎回メモリ再割り当てが発生
   // for(int i = 0; i < 10000; i++)
   // {
   //    ArrayResize(ticks, ++count);
   //    ticks[count - 1] = Bid;
   // }

   // 良い例：reserve_sizeで事前にメモリを確保
   for(int i = 0; i < 10000; i++)
   {
      ArrayResize(ticks, ++count, 10000);  // 最大10000要素分を予約
      ticks[count - 1] = Bid;
   }
}

大量のデータを扱うEAでは、このreserve_sizeの指定が処理速度に大きく影響します。ぜひ覚えておきましょう。

ArrayInitialize() – 全要素を一括で初期化する

ArrayInitialize()は、配列の全要素を指定した値で一括初期化する関数です。

基本構文

int ArrayInitialize(
   double& array[],   // 初期化する配列
   double  value       // セットする値
);

基本的な使い方

void OnStart()
{
   double buffer[10];

   // 全要素を0.0で初期化
   ArrayInitialize(buffer, 0.0);

   for(int i = 0; i < ArraySize(buffer); i++)
      Print("buffer[", i, "] = ", buffer[i]);  // すべて0.0
}

ArrayResizeとの組み合わせが重要

ArrayResize()でサイズを拡張した直後、新しく追加された要素の値は不定（ゴミ値）です。そのため、拡張後にArrayInitialize()で初期化するのが安全なパターンです。

void OnStart()
{
   double data[];

   ArrayResize(data, 10);
   ArrayInitialize(data, 0.0);  // 拡張後は必ず初期化！

   Print("data[5] = ", data[5]);  // 安全に0.0が入っている
}

ArrayCopy() – 配列を別の配列にコピーする

ArrayCopy()は、配列の全体または一部を別の配列にコピーする関数です。

基本構文

int ArrayCopy(
   void& dst_array[],      // コピー先
   const void& src_array[], // コピー元
   int   dst_start=0,       // コピー先の開始位置
   int   src_start=0,       // コピー元の開始位置
   int   count=WHOLE_ARRAY  // コピーする要素数
);

戻り値はコピーされた要素数です。

基本的な使い方

void OnStart()
{
   double source[5] = {1.1, 2.2, 3.3, 4.4, 5.5};
   double dest[];

   // 全要素をコピー（destは自動でリサイズされる）
   ArrayCopy(dest, source);
   Print("dest[2] = ", dest[2]);  // 出力: 3.3

   // 部分コピー：sourceのインデックス1から3要素をdest2のインデックス0にコピー
   double dest2[3];
   ArrayCopy(dest2, source, 0, 1, 3);
   // dest2 = {2.2, 3.3, 4.4}
   for(int i = 0; i < ArraySize(dest2); i++)
      Print("dest2[", i, "] = ", dest2[i]);
}

部分コピーを使いこなすと、直近N本のデータだけを抜き出す処理などが簡潔に書けます。

ArraySort() – 配列をソート（並び替え）する

ArraySort()は、配列の要素を昇順にソートする関数です。

基本構文

bool ArraySort(
   void& array[]   // ソートする配列
);

MQL4のArraySort()は昇順のみに対応しています。

基本的な使い方

void OnStart()
{
   double values[5] = {3.5, 1.2, 4.8, 2.1, 3.9};

   // 昇順ソート
   ArraySort(values);

   for(int i = 0; i < ArraySize(values); i++)
      Print("values[", i, "] = ", values[i]);
   // 出力: 1.2, 2.1, 3.5, 3.9, 4.8
}

降順にしたい場合

MQL4のArraySort()には降順オプションがないため、昇順ソート後に逆順で読むか、別の配列に逆順コピーする方法を使います。

void OnStart()
{
   double values[5] = {3.5, 1.2, 4.8, 2.1, 3.9};

   // まず昇順ソート
   ArraySort(values);

   // 逆順で読み取ることで降順として扱う
   int size = ArraySize(values);
   for(int i = size - 1; i >= 0; i--)
      Print("降順 values[", (size - 1 - i), "] = ", values[i]);
   // 出力: 4.8, 3.9, 3.5, 2.1, 1.2
}

注意点：時系列配列はソートできない

ArraySetAsSeries()で時系列フラグが設定された配列は、ArraySort()でソートできません。ソートしたい場合は、まず通常の配列にコピーしてからソートしましょう。

ArraySetAsSeries() – 時系列インデックスに変換する

ArraySetAsSeries()は、配列のインデックスの方向を時系列方向に変更する関数です。MetaTraderのチャートデータは最新のバー（ローソク足）がインデックス0になっていますが、通常の配列は先頭がインデックス0です。この違いを吸収するのがこの関数です。

基本構文

bool ArraySetAsSeries(
   const void& array[],  // 対象の配列
   bool        flag       // true=時系列, false=通常
);

通常配列と時系列配列の違い

// 通常の配列（左から右へインデックスが増加）
// index:  [0]  [1]  [2]  [3]  [4]
// データ:  古い ←――――――――――→ 新しい

// 時系列配列（右から左へインデックスが増加）
// index:  [4]  [3]  [2]  [1]  [0]
// データ:  古い ←――――――――――→ 新しい

基本的な使い方

void OnStart()
{
   double closeArray[];

   // 直近10本の終値を取得
   ArraySetAsSeries(closeArray, true);  // 時系列方向に設定
   CopyClose(Symbol(), PERIOD_CURRENT, 0, 10, closeArray);

   // closeArray[0] = 最新バーの終値
   // closeArray[1] = 1つ前のバーの終値
   // closeArray[9] = 9つ前のバーの終値
   Print("最新の終値: ", closeArray[0]);
   Print("1つ前の終値: ", closeArray[1]);
}

インジケーター開発での活用

カスタムインジケーターのOnCalculate()関数では、引数として渡される価格配列のインデックス方向が不定の場合があります。そのため、関数の冒頭でArraySetAsSeries()を呼んでインデックス方向を統一するのが定番のパターンです。

int OnCalculate(const int rates_total,
                const int prev_calculated,
                const datetime &time[],
                const double &open[],
                const double &high[],
                const double &low[],
                const double &close[],
                const long &tick_volume[],
                const long &volume[],
                const int &spread[])
{
   // インデックス方向を時系列に統一
   ArraySetAsSeries(close, true);
   ArraySetAsSeries(high, true);
   ArraySetAsSeries(low, true);

   // これで close[0] が最新バーの終値になる
   // ... インジケーターの計算処理 ...

   return(rates_total);
}

実践テクニック：6つの関数を組み合わせて使う

ここまで学んだ6つの関数を組み合わせた実践的なサンプルを見てみましょう。直近N本のバーから最高値トップ3を抽出する処理です。

void OnStart()
{
   int period = 20;  // 直近20本のバーを対象

   // 1. 高値データを格納する動的配列を準備
   double highPrices[];
   ArrayResize(highPrices, period);       // サイズを設定
   ArrayInitialize(highPrices, 0.0);      // 初期化

   // 2. 直近の高値データを取得
   double tempHigh[];
   ArraySetAsSeries(tempHigh, true);      // 時系列方向に設定
   CopyHigh(Symbol(), PERIOD_CURRENT, 0, period, tempHigh);

   // 3. 作業用配列にコピー
   ArrayCopy(highPrices, tempHigh, 0, 0, period);

   // 4. 昇順ソートしてトップ3を取得（末尾3要素が最大値）
   ArraySort(highPrices);

   int size = ArraySize(highPrices);
   Print("=== 直近", period, "本の高値トップ3 ===");
   for(int i = 0; i < 3; i++)
   {
      Print("第", (i + 1), "位: ", highPrices[size - 1 - i]);
   }
}

このように、ArrayResize→ArrayInitialize→ArraySetAsSeries→ArrayCopy→ArraySort→ArraySizeと、6つの関数を自然に組み合わせて使えるようになると、実践的なEA開発がスムーズに進みます。

配列関数 早見表

まとめ

今回はMQL4の主要な配列関数6つについて解説しました。ポイントを振り返りましょう。

• ArraySize()はループ処理の必須パートナー。多次元配列では全要素数が返る点に注意
• ArrayResize()は第3引数のreserve_sizeを活用してパフォーマンスを改善
• ArrayInitialize()はArrayResize後のゴミ値を防ぐために必ずセットで使う
• ArrayCopy()は部分コピーが便利。引数の順番（コピー先が最初）を間違えないように
• ArraySort()はMQL4では昇順のみ。降順が必要なら逆順で読み取る
• ArraySetAsSeries()はインジケーター開発の定番。close[0]を最新バーにするために使う

これら6つの関数を使いこなせれば、EA開発やインジケーター作成の幅が大きく広がります。まずは実際にスクリプトやEAの中で試してみて、配列操作に慣れていきましょう！

投稿 【MQL4】配列関数を完全マスター！ArraySize・ArrayResize・ArraySort・ArrayCopy・ArrayInitialize・ArraySetAsSeriesの使い方 は 自動売買を作ろう！ に最初に表示されました。

MQL4には多くの文字列関数が用意されていますが、この記事では特に使用頻度の高い5つの関数に絞って解説します。

• DoubleToString — 実数を文字列に変換
• IntegerToString — 整数を文字列に変換
• StringFormat — 書式を指定して文字列を生成
• StringLen — 文字列の長さを取得
• StringSubstr — 文字列の一部を切り出す

すべてサンプルコード付きで、最後には5関数を組み合わせた実践例も紹介します。それでは順番に見ていきましょう！

DoubleToString — 実数を文字列に変換する

DoubleToStringは、double型の数値を指定した小数桁数の文字列に変換する関数です。価格やロット数の表示に欠かせません。

基本的な使い方

void OnStart()
{
    double price = 145.123456;

    // 小数点以下3桁で表示
    string s1 = DoubleToString(price, 3);
    Print("3桁: ", s1);  // 出力: 145.123

    // 小数点以下5桁で表示
    string s2 = DoubleToString(price, 5);
    Print("5桁: ", s2);  // 出力: 145.12346（四捨五入される）
}

実践テクニック：_Digits との組み合わせ

通貨ペアによって小数桁数は異なります（USDJPYは3桁、EURUSDは5桁など）。_Digitsを使えば、通貨ペアに応じた桁数で自動的に変換できます。

void OnTick()
{
    double bid = SymbolInfoDouble(_Symbol, SYMBOL_BID);

    // 通貨ペアに合った桁数で文字列化
    string priceStr = DoubleToString(bid, _Digits);
    Print(_Symbol, " の現在価格: ", priceStr);
}

この書き方なら、どの通貨ペアのチャートにEAを適用しても正しい桁数で価格が表示されます。

IntegerToString — 整数を文字列に変換する

IntegerToStringは、整数を文字列に変換する関数です。単純な変換だけでなく、ゼロ埋め（パディング）もできるのが特徴です。

基本的な使い方

void OnStart()
{
    int ticket = 12345;

    // 単純な変換
    string s1 = IntegerToString(ticket);
    Print("チケット: ", s1);  // 出力: 12345
}

ゼロ埋め（パディング）の使い方

IntegerToStringの第2引数で桁数、第3引数で埋める文字を指定できます。ログの整形やファイル名の連番に便利です。

void OnStart()
{
    int num = 42;

    // 6桁にゼロ埋め
    string s1 = IntegerToString(num, 6, '0');
    Print("ゼロ埋め: ", s1);  // 出力: 000042

    // 8桁にスペース埋め（デフォルト）
    string s2 = IntegerToString(num, 8);
    Print("スペース埋め: [", s2, "]");  // 出力: [      42]
}

StringFormat — 書式指定で文字列を組み立てる

StringFormatはC言語のsprintfに相当する関数で、最も万能な文字列生成関数です。複数の値をひとつの文字列にまとめたいときに大活躍します。

主な書式指定子

サンプルコード

void OnStart()
{
    string symbol = "USDJPY";
    double price  = 145.678;
    int    ticket  = 99001;
    double lots   = 0.1;

    // 書式を指定して一気に文字列生成
    string msg = StringFormat("%s | Ticket:%d | Price:%.3f | Lots:%.2f",
                              symbol, ticket, price, lots);
    Print(msg);
    // 出力: USDJPY | Ticket:99001 | Price:145.678 | Lots:0.10
}

StringFormatを使えば、文字列の連結（+演算子）を多用するよりもコードがすっきりします。特に3つ以上の値を組み合わせるときはStringFormatがおすすめです。

StringLen — 文字列の長さを取得する

StringLenは文字列の文字数を返す関数です。入力値のバリデーションや空文字チェックに使います。

基本的な使い方

void OnStart()
{
    string text = "Hello MQL4";
    int len = StringLen(text);
    Print("文字数: ", len);  // 出力: 10（スペースも1文字）

    // 空文字チェック
    string comment = "";
    if(StringLen(comment) == 0)
    {
        Print("コメントは空です");
    }
}

実践テクニック：入力パラメータのチェック

input string MagicPrefix = "EA01";

int OnInit()
{
    // プレフィックスが長すぎないかチェック
    if(StringLen(MagicPrefix) > 10)
    {
        Print("エラー: MagicPrefixは10文字以内にしてください");
        return INIT_PARAMETERS_INCORRECT;
    }
    return INIT_SUCCEEDED;
}

StringSubstr — 文字列の一部を切り出す

StringSubstrは文字列から指定位置・指定長さの部分文字列を取り出す関数です。日時文字列の分解やファイル名の加工に活用できます。

基本的な使い方

void OnStart()
{
    string text = "2024.01.15 09:30:00";

    // 日付部分を取得（先頭から10文字）
    string datePart = StringSubstr(text, 0, 10);
    Print("日付: ", datePart);  // 出力: 2024.01.15

    // 時刻部分を取得（11文字目から最後まで）
    string timePart = StringSubstr(text, 11);
    Print("時刻: ", timePart);  // 出力: 09:30:00

    // 年だけ取得（先頭から4文字）
    string year = StringSubstr(text, 0, 4);
    Print("年: ", year);  // 出力: 2024
}

第2引数が開始位置（0始まり）、第3引数が切り出す文字数です。第3引数を省略すると、開始位置から末尾までの全文字が返されます。

実践テクニック：末尾N文字を切り出す関数

StringLenとStringSubstrを組み合わせると、末尾から指定文字数を取り出すユーティリティ関数が作れます。

// 末尾n文字を取得する関数
string StringRight(string text, int n)
{
    int len = StringLen(text);
    if(n >= len) return text;
    return StringSubstr(text, len - n, n);
}

void OnStart()
{
    string filename = "report_2024.csv";
    string ext = StringRight(filename, 4);
    Print("拡張子: ", ext);  // 出力: .csv
}

実践例：5つの関数を組み合わせた注文ログ出力

最後に、ここまで学んだ5つの関数を全て使った実践的なサンプルを紹介します。注文情報をきれいに整形してログ出力する関数です。

// 注文情報を整形して出力する関数
void PrintOrderInfo(int ticket)
{
    if(!OrderSelect(ticket, SELECT_BY_TICKET))
    {
        Print("チケット ", IntegerToString(ticket), " が見つかりません");
        return;
    }

    string symbol   = OrderSymbol();
    int    type     = OrderType();
    double lots     = OrderLots();
    double openPrice = OrderOpenPrice();
    string comment  = OrderComment();

    // IntegerToString: チケット番号をゼロ埋め
    string ticketStr = IntegerToString(ticket, 8, '0');

    // DoubleToString: 価格を通貨ペアに合った桁数で変換
    int digits = (int)MarketInfo(symbol, MODE_DIGITS);
    string priceStr = DoubleToString(openPrice, digits);

    // StringLen: コメントが空なら代替テキストを設定
    if(StringLen(comment) == 0)
        comment = "(コメントなし)";

    // StringSubstr: コメントが長すぎる場合は20文字に切り詰め
    if(StringLen(comment) > 20)
        comment = StringSubstr(comment, 0, 20) + "...";

    // StringFormat: 全体を整形
    string typeStr = (type == OP_BUY) ? "BUY" : "SELL";
    string log = StringFormat("[%s] %s %s %.2fLots @ %s Comment:%s",
                              ticketStr, symbol, typeStr,
                              lots, priceStr, comment);
    Print(log);
    // 出力例: [00012345] USDJPY BUY 0.10Lots @ 145.678 Comment:MyEA_Entry
}

このように、文字列関数を組み合わせることで読みやすく情報量の多いログが簡単に作れます。デバッグ効率が格段に上がるので、ぜひ活用してください。

まとめ

今回紹介した5つの文字列関数のポイントを整理します。

これらの関数はEA開発のあらゆる場面で登場します。特にStringFormatは使いこなせると、Print文やComment表示が一気にスマートになります。まずはサンプルコードをコピーして動かしてみるところから始めてみてください！

投稿 【MQL4】文字列関数を完全マスター！StringFormat・DoubleToString・IntegerToString・StringLen・StringSubstrの使い方 は 自動売買を作ろう！ に最初に表示されました。