今回は、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の使い方 は 自動売買を作ろう！ に最初に表示されました。

この記事では、ObjectCreate・ObjectDelete・ObjectSetInteger・ObjectSetDouble・ObjectSetStringといった主要関数の使い方を、実践的なコードサンプルとともに徹底解説します。最後には情報パネルを表示するインジケーターの完全コードも用意していますので、ぜひ最後までお読みください。

チャートオブジェクト関数とは？

チャートオブジェクト関数とは、MetaTrader 4のチャート上にライン・図形・テキストなどの「オブジェクト」をプログラムから作成・変更・削除するための関数群です。

手動でチャートに水平線やトレンドラインを描くのと同じことを、MQL4のコードから自動的に行えるようになります。EAでエントリーポイントにマークを付けたり、インジケーターで情報パネルを表示したりと、用途は非常に幅広いです。

ObjectCreate — オブジェクトを作成する

ObjectCreate関数は、チャート上に新しいオブジェクトを作成するための関数です。基本的な書式は以下のとおりです。

bool ObjectCreate(
    string name,       // オブジェクト名（一意な名前を付ける）
    int    type,       // オブジェクトの種類（ENUM_OBJECT）
    int    sub_window, // サブウィンドウ番号（0=メインチャート）
    datetime time1,    // 第1アンカーポイントの時刻
    double   price1,   // 第1アンカーポイントの価格
    ...                // 必要に応じて第2、第3アンカーポイント
);

主なオブジェクト種類（ENUM_OBJECT）一覧

水平線を作成するサンプル

最もシンプルな例として、現在の価格に水平線を引いてみましょう。

void CreateHLine()
{
    string name = "MyHLine";
    double price = Ask;

    // 既に同名のオブジェクトがあれば削除
    if(ObjectFind(name) >= 0)
        ObjectDelete(name);

    // 水平線を作成
    ObjectCreate(name, OBJ_HLINE, 0, 0, price);

    // 色を赤に設定
    ObjectSetInteger(0, name, OBJPROP_COLOR, clrRed);

    // チャートを再描画して反映
    ChartRedraw();
}

ObjectCreateは成功するとtrue、失敗するとfalseを返します。同じ名前のオブジェクトが既に存在する場合は失敗するため、事前にObjectFindで確認するか、先に削除しておくのがポイントです。

ObjectDelete — オブジェクトを削除する

ObjectDelete関数でチャート上のオブジェクトを削除できます。

// 名前を指定して削除
bool ObjectDelete(string name);

// チャートIDを指定して削除（MQL4でも使用可能）
bool ObjectDelete(long chart_id, string name);

使用例：オブジェクトの削除

void RemoveMyObjects()
{
    ObjectDelete("MyHLine");
    ObjectDelete("MyLabel");
    ChartRedraw();
}

⚠️ OnDeinitでの注意点

ObjectDelete関数は非同期で実行されます。つまり、関数を呼び出した瞬間に削除が完了するとは限りません。特にOnDeinit関数内で呼び出す場合、処理が即座に反映されないことがあります。

確実にオブジェクトを削除したい場合は、ObjectsDeleteAll関数を使うか、ObjectDeleteの後にChartRedrawを呼ぶようにしましょう。

void OnDeinit(const int reason)
{
    // プレフィックスが一致するオブジェクトを一括削除
    ObjectsDeleteAll(0, "MyPrefix_");
    ChartRedraw();
}

ObjectsDeleteAllの第2引数にプレフィックス（接頭辞）を指定すると、その文字列で始まる名前のオブジェクトだけを一括削除できます。自作オブジェクトに統一のプレフィックスを付ける習慣を身につけると、管理がとても楽になります。

ObjectSetInteger — 整数プロパティを設定する

ObjectSetInteger関数は、オブジェクトの色・線種・太さなどの整数型プロパティを変更します。

よく使うプロパティ一覧

プロパティ設定のサンプル

void StyleHLine(string name)
{
    // 色を青に変更
    ObjectSetInteger(0, name, OBJPROP_COLOR, clrDodgerBlue);

    // 破線スタイルに変更
    ObjectSetInteger(0, name, OBJPROP_STYLE, STYLE_DASH);

    // 線の太さを2に変更
    ObjectSetInteger(0, name, OBJPROP_WIDTH, 2);

    // ユーザーが選択できないようにする
    ObjectSetInteger(0, name, OBJPROP_SELECTABLE, false);

    // オブジェクトリストに表示しない
    ObjectSetInteger(0, name, OBJPROP_HIDDEN, true);

    ChartRedraw();
}

OBJPROP_SELECTABLEとOBJPROP_HIDDENを設定しておくと、ユーザーが誤ってオブジェクトを移動・削除してしまうのを防げます。EA・インジケーターで自動生成するオブジェクトには、これらを設定しておくのがおすすめです。

ObjectSetDouble / ObjectGetDouble — 実数プロパティの設定と取得

ObjectSetDoubleで価格などのdouble型プロパティを設定し、ObjectGetDoubleで取得できます。

// 水平線の価格を変更する
void MoveHLine(string name, double newPrice)
{
    ObjectSetDouble(0, name, OBJPROP_PRICE, newPrice);
    ChartRedraw();
}

// 水平線の現在の価格を取得する
double GetHLinePrice(string name)
{
    return ObjectGetDouble(0, name, OBJPROP_PRICE);
}

例えば、ユーザーが手動でドラッグした水平線の位置をObjectGetDoubleで読み取り、EAのストップロスやテイクプロフィットに利用するといった活用ができます。

void OnTick()
{
    // ユーザーが配置した "SL_Line" の価格を取得
    if(ObjectFind("SL_Line") >= 0)
    {
        double slPrice = ObjectGetDouble(0, "SL_Line", OBJPROP_PRICE);
        Print("ストップロス価格: ", slPrice);
    }
}

ObjectSetString — 文字列プロパティを設定する

ObjectSetStringは、テキスト内容やフォント名などの文字列型プロパティを変更します。OBJ_LABELやOBJ_TEXTオブジェクトで特によく使います。

void CreateTextLabel(string name, string text, int x, int y)
{
    if(ObjectFind(name) >= 0)
        ObjectDelete(name);

    // ラベルオブジェクトを作成
    ObjectCreate(name, OBJ_LABEL, 0, 0, 0);

    // 表示位置を設定（ピクセル座標）
    ObjectSetInteger(0, name, OBJPROP_XDISTANCE, x);
    ObjectSetInteger(0, name, OBJPROP_YDISTANCE, y);
    ObjectSetInteger(0, name, OBJPROP_CORNER, CORNER_LEFT_UPPER);

    // テキスト内容を設定
    ObjectSetString(0, name, OBJPROP_TEXT, text);

    // フォントを設定
    ObjectSetString(0, name, OBJPROP_FONT, "Arial Bold");

    // フォントサイズと色
    ObjectSetInteger(0, name, OBJPROP_FONTSIZE, 12);
    ObjectSetInteger(0, name, OBJPROP_COLOR, clrWhite);

    // 選択不可・リスト非表示
    ObjectSetInteger(0, name, OBJPROP_SELECTABLE, false);
    ObjectSetInteger(0, name, OBJPROP_HIDDEN, true);

    ChartRedraw();
}

OBJ_LABELはチャートの価格・時刻座標ではなく、ピクセル座標で位置を指定するオブジェクトです。OBJPROP_CORNERでどの角を基準にするかを決め、OBJPROP_XDISTANCEとOBJPROP_YDISTANCEでその角からの距離を指定します。チャートをスクロールしても位置が固定されるため、情報表示パネルに最適です。

実践サンプル：情報パネルを表示するインジケーター

ここまで学んだ関数を組み合わせて、チャート左上に通貨ペア情報・スプレッド・サーバー時刻を表示する情報パネルインジケーターを作ってみましょう。

//+------------------------------------------------------------------+
//| InfoPanel.mq4 - 情報パネル表示インジケーター                      |
//+------------------------------------------------------------------+
#property indicator_chart_window
#property strict

// オブジェクト名のプレフィックス
#define PREFIX "InfoPanel_"

//+------------------------------------------------------------------+
//| ラベル作成ヘルパー関数                                            |
//+------------------------------------------------------------------+
void CreateLabel(string name, int x, int y, string text,
                 color clr=clrWhite, int fontSize=11)
{
    string fullName = PREFIX + name;

    if(ObjectFind(fullName) < 0)
        ObjectCreate(fullName, OBJ_LABEL, 0, 0, 0);

    ObjectSetInteger(0, fullName, OBJPROP_CORNER, CORNER_LEFT_UPPER);
    ObjectSetInteger(0, fullName, OBJPROP_XDISTANCE, x);
    ObjectSetInteger(0, fullName, OBJPROP_YDISTANCE, y);
    ObjectSetString(0, fullName, OBJPROP_TEXT, text);
    ObjectSetString(0, fullName, OBJPROP_FONT, "Consolas");
    ObjectSetInteger(0, fullName, OBJPROP_FONTSIZE, fontSize);
    ObjectSetInteger(0, fullName, OBJPROP_COLOR, clr);
    ObjectSetInteger(0, fullName, OBJPROP_SELECTABLE, false);
    ObjectSetInteger(0, fullName, OBJPROP_HIDDEN, true);
}

//+------------------------------------------------------------------+
//| 背景パネル作成関数                                                |
//+------------------------------------------------------------------+
void CreateBackground()
{
    string name = PREFIX + "BG";

    if(ObjectFind(name) < 0)
        ObjectCreate(name, OBJ_RECTANGLE_LABEL, 0, 0, 0);

    ObjectSetInteger(0, name, OBJPROP_CORNER, CORNER_LEFT_UPPER);
    ObjectSetInteger(0, name, OBJPROP_XDISTANCE, 10);
    ObjectSetInteger(0, name, OBJPROP_YDISTANCE, 20);
    ObjectSetInteger(0, name, OBJPROP_XSIZE, 260);
    ObjectSetInteger(0, name, OBJPROP_YSIZE, 100);
    ObjectSetInteger(0, name, OBJPROP_BGCOLOR, C'30,30,50');
    ObjectSetInteger(0, name, OBJPROP_BORDER_TYPE, BORDER_FLAT);
    ObjectSetInteger(0, name, OBJPROP_COLOR, clrDodgerBlue);
    ObjectSetInteger(0, name, OBJPROP_WIDTH, 1);
    ObjectSetInteger(0, name, OBJPROP_BACK, false);
    ObjectSetInteger(0, name, OBJPROP_SELECTABLE, false);
    ObjectSetInteger(0, name, OBJPROP_HIDDEN, true);
}

//+------------------------------------------------------------------+
//| 初期化                                                            |
//+------------------------------------------------------------------+
int OnInit()
{
    CreateBackground();
    return(INIT_SUCCEEDED);
}

//+------------------------------------------------------------------+
//| メイン処理                                                        |
//+------------------------------------------------------------------+
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[])
{
    // 通貨ペアと時間足
    string tfStr = "";
    switch(Period())
    {
        case PERIOD_M1:  tfStr = "M1";  break;
        case PERIOD_M5:  tfStr = "M5";  break;
        case PERIOD_M15: tfStr = "M15"; break;
        case PERIOD_M30: tfStr = "M30"; break;
        case PERIOD_H1:  tfStr = "H1";  break;
        case PERIOD_H4:  tfStr = "H4";  break;
        case PERIOD_D1:  tfStr = "D1";  break;
        case PERIOD_W1:  tfStr = "W1";  break;
        case PERIOD_MN1: tfStr = "MN";  break;
        default:         tfStr = "??";  break;
    }
    CreateLabel("Symbol", 20, 28,
                Symbol() + " / " + tfStr,
                clrDodgerBlue, 13);

    // スプレッド
    double spreadPips = MarketInfo(Symbol(), MODE_SPREAD) / 10.0;
    color spreadClr = (spreadPips < 2.0) ? clrLimeGreen : clrOrangeRed;
    CreateLabel("Spread", 20, 52,
                "Spread: " + DoubleToString(spreadPips, 1) + " pips",
                spreadClr, 11);

    // サーバー時刻
    CreateLabel("Time", 20, 75,
                "Server: " + TimeToString(TimeCurrent(), TIME_DATE|TIME_SECONDS),
                clrSilver, 10);

    ChartRedraw();
    return(rates_total);
}

//+------------------------------------------------------------------+
//| 終了処理                                                          |
//+------------------------------------------------------------------+
void OnDeinit(const int reason)
{
    ObjectsDeleteAll(0, PREFIX);
    ChartRedraw();
}

このインジケーターをチャートに適用すると、左上にダークブルーの背景パネルが表示され、通貨ペア・時間足・スプレッド・サーバー時刻がリアルタイムで更新されます。スプレッドが2.0pips未満なら緑色、それ以上ならオレンジ色で表示される仕組みです。

よくあるミスと対策

1. オブジェクト名の重複

ObjectCreateは、既に同名のオブジェクトが存在するとfalseを返して失敗します。オブジェクトを更新したい場合は、先にObjectFindで存在チェックをするか、ObjectDeleteで削除してから再作成しましょう。

上記の実践サンプルのように、既に存在する場合はObjectCreateをスキップしてプロパティだけ更新するパターンも効率的です。

2. ChartRedraw()の呼び忘れ

オブジェクトの作成や変更後にChartRedraw()を呼ばないと、画面に変更が反映されません。特にOnCalculateやOnTickの中でオブジェクトを操作した場合、最後に必ずChartRedraw()を呼ぶ習慣をつけましょう。

// NG: 表示が更新されないことがある
ObjectSetString(0, "label1", OBJPROP_TEXT, "新しいテキスト");

// OK: 確実に画面に反映される
ObjectSetString(0, "label1", OBJPROP_TEXT, "新しいテキスト");
ChartRedraw();

3. OnDeinitでの削除漏れ

インジケーターやEAを削除したとき、作成したオブジェクトがチャートに残ってしまうのはよくあるミスです。OnDeinit関数内で必ずオブジェクトを削除しましょう。

おすすめは、すべてのオブジェクト名に共通のプレフィックスを付けて、ObjectsDeleteAll(0, PREFIX)で一括削除する方法です。この方法なら、オブジェクトを追加した際に削除コードの更新を忘れる心配がありません。

まとめ

今回はMQL4のチャートオブジェクト関数について解説しました。ポイントを整理します。

• ObjectCreateでオブジェクトを作成。同名オブジェクトの存在チェックを忘れずに
• ObjectDelete / ObjectsDeleteAllで削除。プレフィックスを活用した一括削除が便利
• ObjectSetIntegerで色・線種・太さ・座標などを設定
• ObjectSetDouble / ObjectGetDoubleで価格値の設定・取得
• ObjectSetStringでテキスト内容やフォントを変更
• 操作後はChartRedraw()で画面を再描画
• OnDeinitでは必ずオブジェクトを削除して後片付け

チャートオブジェクト関数を使いこなせるようになると、EAやインジケーターの視覚的な表現力が大幅にアップします。まずは水平線やテキストラベルなど、シンプルなオブジェクトから試してみてください。慣れてきたら、今回の情報パネルサンプルをベースに、自分だけのカスタムパネルを作ってみましょう！

投稿 【MQL4入門】チャートオブジェクト関数を完全攻略！ObjectCreate・ObjectDelete・ObjectSetの使い方 は 自動売買を作ろう！ に最初に表示されました。

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

この記事では、MQL4でローソク足の始値・終値・高値・安値・開始時刻を取得するための5つの関数――iOpen()、iClose()、iHigh()、iLow()、iTime()の使い方を、サンプルコード付きでわかりやすく解説します。

5つの時系列アクセス関数の概要

MQL4には、ローソク足（バー）の価格情報を取得するための時系列アクセス関数が用意されています。iOpen関数は指定した通貨ペア・時間軸・バーシフトに対応するバーの始値を、iClose関数は終値を、iHigh関数は高値を、iLow関数は安値を返す関数です。それぞれの役割は以下のとおりです。

5つの関数はすべて同じ引数の構成を持っており、一度覚えればすべてすぐに使いこなせます。

関数の書式と引数の意味

ここではiClose()を例に解説しますが、他の4つの関数もまったく同じ形式です。

double iClose(
    string symbol,    // 通貨ペア名
    int    timeframe, // 時間軸
    int    shift      // バーの位置（シフト）
);

① symbol（通貨ペア名）

通貨ペア名は「気配値表示ウィンドウ」に表示されているとおりに記述します。特定の通貨ペア名を指定せず、EA等を適用したチャートの通貨ペアの終値を取得したい場合は、「NULL」と記述します。

• NULL または Symbol() → EAやインジケーターを適用中のチャートの通貨ペア
• "USDJPY" → ドル円を明示的に指定
• "EURUSD" → ユーロドルを明示的に指定

通貨ペアを直接記述するとどの通貨ペアチャートにセットしてもその通貨ペアを強制的にトレードしてしまうため、Symbol()と記述しましょう。

② timeframe（時間軸）

どの時間足のデータを取得するかを指定します。0またはPERIOD定数を使います。

0を指定すると、EAやインジケーターを適用しているチャートの時間足が自動的に使われます。マルチタイムフレーム分析（MTF）を行いたい場合は、ここに上位足の定数を明示的に指定します。

③ shift（バーの位置）

終値を取得したいバーが現在のバーであれば「０」、１本前のバーであれば「１」、２本前のバーであれば「２」……と記述します。

• 0 → 現在（最新）のバー
• 1 → 1本前のバー
• 2 → 2本前のバー
• n → n本前のバー

同じ記述でも時間が進むにつれて値が変化します。数字が大きくなるほど過去のバーを参照します。なお、shift=0の最新バーはまだ形成中なので、確定した値を使いたい場合はshift=1以降を使うのが一般的です。

基本的な使い方 ― 各関数のサンプルコード

まずは5つの関数それぞれを使って、ログにローソク足情報を出力する基本例を見てみましょう。

//+------------------------------------------------------------------+
//| 各時系列アクセス関数の基本的な使い方                                 |
//+------------------------------------------------------------------+
#property strict

void OnInit()
{
    // 1本前（確定済み）のバーの各値を取得
    double openPrice  = iOpen(NULL, 0, 1);
    double closePrice = iClose(NULL, 0, 1);
    double highPrice  = iHigh(NULL, 0, 1);
    double lowPrice   = iLow(NULL, 0, 1);
    datetime barTime  = iTime(NULL, 0, 1);

    Print("=== 1本前のローソク足情報 ===");
    Print("開始時刻: ", TimeToString(barTime, TIME_DATE | TIME_MINUTES));
    Print("始値:     ", DoubleToString(openPrice, Digits));
    Print("高値:     ", DoubleToString(highPrice, Digits));
    Print("安値:     ", DoubleToString(lowPrice, Digits));
    Print("終値:     ", DoubleToString(closePrice, Digits));
}

このコードをEAとしてコンパイルし、チャートにセットすると、「エキスパート」タブに1本前のバーの情報が表示されます。NULLと0を指定しているので、適用したチャートの通貨ペアと時間足のデータが自動的に使われます。

実践サンプル① ― 陽線・陰線を判定する

EA開発でよく使うのが「前のローソク足が陽線だったか陰線だったか」の判定です。始値と終値を比較するだけで簡単に実現できます。

//+------------------------------------------------------------------+
//| 1本前のローソク足が陽線か陰線かを判定                               |
//+------------------------------------------------------------------+
void OnTick()
{
    double prevOpen  = iOpen(Symbol(), 0, 1);
    double prevClose = iClose(Symbol(), 0, 1);

    if(prevClose > prevOpen)
    {
        // 陽線（終値 > 始値）
        Print("1本前は陽線です（上昇）");
    }
    else if(prevClose < prevOpen)
    {
        // 陰線（終値 < 始値）
        Print("1本前は陰線です（下降）");
    }
    else
    {
        // 同値（十字線など）
        Print("1本前は同値線です");
    }
}

「2本連続で陽線なら買いエントリー」といった条件も、shift=1とshift=2を使って簡単に書けます。

実践サンプル② ― 直近N本の最高値・最安値を求める

forループとiHigh/iLowを組み合わせれば、直近N本のバーの中から最高値・最安値を見つけることができます。

//+------------------------------------------------------------------+
//| 直近N本のバーから最高値・最安値を算出                                |
//+------------------------------------------------------------------+
void OnTick()
{
    int lookback = 20;  // 過去20本分を調べる
    double highest = 0;
    double lowest  = 999999;

    for(int i = 1; i <= lookback; i++)
    {
        double h = iHigh(NULL, 0, i);
        double l = iLow(NULL, 0, i);

        if(h > highest) highest = h;
        if(l < lowest)  lowest  = l;
    }

    Print("直近", lookback, "本の最高値: ", DoubleToString(highest, Digits));
    Print("直近", lookback, "本の最安値: ", DoubleToString(lowest, Digits));
}

※ブレイクアウト戦略やレンジ判定のロジックに応用できます。

実践サンプル③ ― マルチタイムフレーム（MTF）で上位足の値を取得

「チャートの時間足を切り替えても、常に4時間足のオープン時間を取得したい！」という場合にはiTime()関数を使用して引数に「PERIOD_H4」を渡してあげる必要があります。また、EAやインジケーターを適用したチャートの通貨ペアはUSD/JPYだが、取得したい情報がEUR/JPYのものである場合でもiTime()関数が活躍します。これは他のiClose()、iHigh()なども同様です。

//+------------------------------------------------------------------+
//| 5分足チャート上から日足・4時間足のデータを取得する例                   |
//+------------------------------------------------------------------+
void OnTick()
{
    // 日足の1本前の終値
    double dailyClose = iClose(NULL, PERIOD_D1, 1);
    // 4時間足の1本前の高値
    double h4High     = iHigh(NULL, PERIOD_H4, 1);
    // 4時間足の1本前の安値
    double h4Low      = iLow(NULL, PERIOD_H4, 1);
    // 日足の1本前の開始時刻
    datetime dailyTime = iTime(NULL, PERIOD_D1, 1);

    Print("前日の終値: ", DoubleToString(dailyClose, Digits));
    Print("前日の開始時刻: ", TimeToString(dailyTime, TIME_DATE));
    Print("4H前回バーの高値: ", DoubleToString(h4High, Digits));
    Print("4H前回バーの安値: ", DoubleToString(h4Low, Digits));
}

たとえば5分足チャート上で「前日の高値・安値」をラインとして引いたり、「4時間足が上昇トレンドなら5分足で押し目買いだけを行う」といったMTFロジックを組むときに活躍します。

定義済み配列 Open[] / Close[] / High[] / Low[] / Time[] との違い

MQL4には、i〇〇()関数とは別に、Open[]、Close[]、High[]、Low[]、Time[]という定義済み配列も用意されています。EA等を適用したチャートにおける終値は定義済み配列であるClose[]に格納されており、EA等を適用したチャートにおける終値を取得したい場合はClose[]を使用し、EA等を適用したチャート以外の通貨ペアや時間軸における終値を取得したい場合はiClose()関数を使用します。使い分けのポイントは次のとおりです。

なお、iClose(NULL, 0, 1)とClose[1]は同じ値を返します。どちらを使っても結果は同じですが、後からMTF対応に拡張する可能性がある場合は、最初からi〇〇()関数で書いておくと修正が楽です。

よくある注意点・落とし穴

shift=0 は未確定のバー

iClose(NULL, 0, 0) で取得できる終値は、現在形成中のバーの最新価格です。ティックが入るたびに値が変わるため、売買判断には確定済みのshift=1を使うのが安全です。

ローカル履歴がない場合は0が返る

ローカル履歴がない（読み込まれていない）場合、関数は0を返します。特にマルチタイムフレームや他通貨ペアのデータを使う場合は、事前にヒストリーデータを取得しておきましょう。

Symbol()を使おう

通貨ペア名は"USDJPY"のように直接書くこともできますが、Symbol()やNULLを使えば、どのチャートにセットしても自動的にそのチャートの通貨ペアが適用されるので、汎用性の高いEAが作れます。

まとめ

今回学んだ5つの時系列アクセス関数をおさらいしましょう。

• iOpen(symbol, timeframe, shift) → 始値を取得
• iClose(symbol, timeframe, shift) → 終値を取得
• iHigh(symbol, timeframe, shift) → 高値を取得
• iLow(symbol, timeframe, shift) → 安値を取得
• iTime(symbol, timeframe, shift) → バーの形成開始時刻を取得

すべて同じ3つの引数（通貨ペア・時間軸・バー位置）で統一されているため、1つ覚えれば残りもすぐに使えます。

これらの関数は、陽線・陰線の判定、ブレイクアウト戦略、マルチタイムフレーム分析など、EA開発のあらゆる場面で必要になります。ぜひサンプルコードを実際にMT4のMetaEditorに入力して動かし、手を動かしながら身につけていきましょう！

投稿 【MQL4入門】iClose・iOpen・iHigh・iLow・iTimeで過去のローソク足データを取得しよう は 自動売買を作ろう！ に最初に表示されました。

iCustom関数を使えば、MT4のIndicatorsフォルダにあるカスタムインジケーターの値をEA（エキスパートアドバイザー）から自由に取得できます。つまり、チャート上で矢印やラインを表示するインジケーターのシグナルを、そのまま自動売買のロジックに組み込めるのです。

この記事では、iCustom関数の基本的な構文から、実践的なサンプルコードまで、初心者にもわかりやすく解説していきます。

iCustom関数とは？

iCustom関数は、指定したカスタムインジケーターの計算結果（バッファの値）を取得するMQL4の組み込み関数です。

MT4にはiMA（移動平均線）やiRSI（RSI）など、標準インジケーター用の関数が用意されていますが、自作のインジケーターやネットで配布されているインジケーターにはこうした専用関数がありません。そこで活躍するのがiCustom関数です。

iCustom関数を利用すると、Indicatorsフォルダに保存されているあらゆるカスタムインジケーターの値を取得できます。これにより、インジケーターのシグナルをEAのエントリー条件・決済条件として使うことが可能になります。

iCustom関数の構文（シンタックス）

iCustom関数の基本構文は以下の通りです。

double iCustom(
    string symbol,      // 通貨ペア（NULLで現在のチャート）
    int    timeframe,    // 時間足（0で現在の時間足）
    string name,         // カスタムインジケーター名
    ...                  // インジケーターの入力パラメーター（可変）
    int    mode,         // バッファ番号（0〜7）
    int    shift         // 取得するバーの位置（0が最新）
);

各パラメーターの意味を詳しく見ていきましょう。

① symbol（通貨ペア）

値を取得したい通貨ペアを文字列で指定します。現在のチャートの通貨ペアを指定する場合は NULL または _Symbol を使います。別の通貨ペアを指定したい場合は "USDJPY" のように気配値表示ウィンドウの表記通りに記述します。

② timeframe（時間足）

時間軸の種類を指定します。現在のチャートの時間足を使う場合は 0 または PERIOD_CURRENT を指定します。別の時間足を指定する場合は、以下の定数を使います。

③ name（インジケーター名）

カスタムインジケーター名を文字列で指定します。指定するカスタムインジケーターの.ex4ファイルが、MQL4\Indicatorsフォルダまたはそのサブフォルダに保存されている必要があります。

サブディレクトリに配置されている場合は、”サブディレクトリ名\\カスタムインジケータ名”で指定します。

// Indicatorsフォルダ直下の場合
iCustom(NULL, 0, "MyIndicator", ...);

// サブフォルダ「Examples」内の場合
iCustom(NULL, 0, "Examples\\MyIndicator", ...);

④ …（インジケーターの入力パラメーター）

カスタムインジケータの入力パラメータです。渡された入力パラメータの順序は、カスタムインジケータの宣言順に対応する必要があります。ここが一番混乱しやすいポイントです。

パラメーターを省略した場合は、インジケーター側のデフォルト値が使用されます。ただし、途中のパラメーターだけを省略することはできません。変更したいパラメーターより前のパラメーターは、すべてデフォルト値であっても記述する必要があります。

⑤ mode（バッファ番号）

取得したいインジケーターバッファのインデックス番号（0〜7）を指定します。最初のバッファはmode=0です。

例えば、ボリンジャーバンドのようなインジケーターなら：

• バッファ0：ミドルバンド
• バッファ1：アッパーバンド
• バッファ2：ロワーバンド

のように対応します。バッファ番号の確認方法は後述します。

⑥ shift（バーの位置）

カスタムインジケーターの値を取得したいバーの位置を指定します。現在のバーであれば「0」、1本前のバーであれば「1」、2本前のバーであれば「2」と記述します。

EA内では、確定した値を使うため shift=1（1本前の確定バー）を指定するのが一般的です。

バッファ番号の調べ方

iCustom関数を使ううえで最も重要なのが、正しいバッファ番号を知ることです。バッファ番号を間違えると、まったく違う値を取得してしまいます。

方法1：チャート上でマウスカーソルを合わせる

チャート上にセットしたインジケーターのラインや矢印にマウスカーソルをのせて、Value1やValue2などという表示がでれば、iCustomでEA化できます。

方法2：データウィンドウで確認する

MT4の「表示」→「データウィンドウ」を開くと、各インジケーターのバッファ値が一覧で表示されます。上から順に0, 1, 2…のバッファ番号に対応しています。

方法3：ソースコードを確認する

インジケーターの.mq4ファイルがある場合は、SetIndexBuffer() や SetIndexLabel() の記述からバッファ番号を確認できます。

// ソースコードの例
SetIndexBuffer(0, UpperBuffer);  // バッファ0 → アッパーライン
SetIndexBuffer(1, LowerBuffer);  // バッファ1 → ロワーライン
SetIndexBuffer(2, BuySignal);    // バッファ2 → 買いシグナル
SetIndexBuffer(3, SellSignal);   // バッファ3 → 売りシグナル

基本的な使い方：サンプルコード

ここからは、実際のサンプルコードを使って使い方を解説します。

サンプル1：移動平均線カスタムインジケーターの値を取得

まずは、最もシンプルな例です。カスタムインジケーター「MyMA」の値を取得してチャートにコメント表示します。

void OnTick()
{
    // MyMAインジケーターの値を取得（期間20、バッファ0、1本前のバー）
    double ma_value = iCustom(NULL, 0, "MyMA", 20, 0, 1);
    
    // チャートにコメント表示
    Comment("MyMA(20)の値: ", DoubleToString(ma_value, Digits));
}

サンプル2：ボリンジャーバンドカスタムインジケーターの複数バッファを取得

iCustom関数でボリンジャーバンドの値を取得する例です。

void OnTick()
{
    // Bandsインジケーターの各バンドを取得
    int period = 20;
    double deviation = 2.0;
    
    double upper = iCustom(NULL, 0, "Bands", period, 0, deviation, 1, 0);  // アッパーバンド（バッファ1）
    double lower = iCustom(NULL, 0, "Bands", period, 0, deviation, 2, 0);  // ロワーバンド（バッファ2）
    
    Comment("Upper: ", upper, "\nLower: ", lower);
}

サンプル3：矢印シグナルインジケーターでEA化する

これが最も実践的な使い方です。買い矢印・売り矢印を表示するインジケーターのシグナルを使って自動売買するEAのサンプルです。

#property strict

// --- 入力パラメーター ---
input double Lots       = 0.01;    // ロット数
input int    MagicNumber = 12345;  // マジックナンバー
input int    StopLoss    = 50;     // ストップロス（pips）
input int    TakeProfit  = 100;    // テイクプロフィット（pips）

void OnTick()
{
    // --- カスタムインジケーターのシグナル取得 ---
    // 買いシグナル（バッファ0）と売りシグナル（バッファ1）を1本前のバーから取得
    double buySignal  = iCustom(NULL, 0, "MySignalIndicator", 0, 1);
    double sellSignal = iCustom(NULL, 0, "MySignalIndicator", 1, 1);
    
    // --- 現在のポジション数をカウント ---
    int buyCount = 0, sellCount = 0;
    for(int i = OrdersTotal() - 1; i >= 0; i--)
    {
        if(!OrderSelect(i, SELECT_BY_POS, MODE_TRADES)) continue;
        if(OrderSymbol() != Symbol() || OrderMagicNumber() != MagicNumber) continue;
        if(OrderType() == OP_BUY)  buyCount++;
        if(OrderType() == OP_SELL) sellCount++;
    }
    
    // --- 買いエントリー ---
    // シグナルが EMPTY_VALUE でなければ矢印が出現している
    if(buySignal != EMPTY_VALUE && buySignal != 0 && buyCount == 0)
    {
        double sl = Ask - StopLoss * Point * 10;
        double tp = Ask + TakeProfit * Point * 10;
        int ticket = OrderSend(Symbol(), OP_BUY, Lots, Ask, 3, sl, tp,
                               "iCustom Buy", MagicNumber, 0, clrBlue);
        if(ticket < 0)
            Print("買い注文エラー: ", GetLastError());
    }
    
    // --- 売りエントリー ---
    if(sellSignal != EMPTY_VALUE && sellSignal != 0 && sellCount == 0)
    {
        double sl = Bid + StopLoss * Point * 10;
        double tp = Bid - TakeProfit * Point * 10;
        int ticket = OrderSend(Symbol(), OP_SELL, Lots, Bid, 3, sl, tp,
                               "iCustom Sell", MagicNumber, 0, clrRed);
        if(ticket < 0)
            Print("売り注文エラー: ", GetLastError());
    }
}

ポイントは、矢印が表示されていないバーでは EMPTY_VALUE（空の値）が返されるという点です。矢印系のシグナルインジケーターをEA化する場合、この EMPTY_VALUE との比較がエントリー判定の基本パターンになります。

iCustom関数を使う際の注意点

1. .ex4ファイルが必要

iCustom関数が参照するのは、コンパイル済みの.ex4ファイルです。ソースコード（.mq4）だけではなく、必ずコンパイルして.ex4ファイルを生成しておきましょう。

2. バッファレスインジケーターには使えない

オシレーター系のインジケーターの場合はバッファが不可欠なので問題ないのですが、メインチャートに表示される矢印系のインジケーターの場合にはバッファで処理していないことがあります。「バッファでシグナルを処理するようにプログラミングしていないこと」、これがiCustomでインジケーターをEA化できない原因です。バッファレスインジケーターはiCustomではEA化できません。

3. パラメーターの順序と型に注意

入力パラメーターはインジケーターのソースコードで宣言された順番通りに指定する必要があります。順番を間違えたり、型が合わないと正しい値が返りません。

4. パフォーマンスを意識する

iCustom関数は呼び出すたびに計算が実行されるため、ティックごとに何度も呼び出すとパフォーマンスが低下します。新しいバーが確定したタイミングでのみ呼び出し、データをキャッシュすると処理速度を改善できます。

// 新しいバーの判定例
static datetime lastBarTime = 0;
if(Time[0] != lastBarTime)
{
    lastBarTime = Time[0];
    // ここでiCustomを呼び出す
    double signal = iCustom(NULL, 0, "MyIndicator", 0, 1);
}

5. バッファ番号は0〜7の範囲

MT4ではインジケーターバッファのインデックスは0〜7の8個までです。バッファが8個を超えるインジケーターの場合、すべての値をiCustomで取得できるとは限りません。

まとめ

iCustom関数は、カスタムインジケーターのシグナルをEAに組み込むための必須関数です。この記事のポイントをまとめます。

• iCustom関数を使えば、Indicatorsフォルダにあるカスタムインジケーターの値をEAから取得できる
• パラメーターは「通貨ペア → 時間足 → インジケーター名 → 入力パラメーター → バッファ番号 → バー位置」の順に指定する
• バッファ番号の確認は、データウィンドウやソースコードから行う
• 矢印シグナル系のインジケーターは EMPTY_VALUE との比較でシグナル判定する
• バッファレスインジケーター（バッファを使わずオブジェクトで描画するもの）には使えない
• パフォーマンスのため、新しいバー確定時にのみ呼び出す工夫をすると良い

まずは簡単なインジケーターから試して、iCustom関数の使い方に慣れていきましょう。シグナルインジケーターをEA化できるようになれば、自動売買の幅が大きく広がりますよ！

投稿 【MQL4】iCustom関数の使い方を徹底解説！カスタムインジケーターをEAから呼び出す方法とサンプルコード は 自動売買を作ろう！ に最初に表示されました。

MQL4ではiWPR関数を使うことで、このウィリアムズ%Rの値を簡単に取得できます。この記事では、iWPR関数の基本的な使い方から、実践的なEA（自動売買）への応用まで、段階的にわかりやすく解説していきます。

ウィリアムズ%Rとは？

ウィリアムズ%Rは、一定期間における最高値と最安値の範囲のなかで、現在の終値がどの位置にあるかをパーセンテージで示す指標です。

計算式

ウィリアムズ%Rの計算式は以下のとおりです。

// ウィリアムズ%Rの計算式（概念）
// %R = (期間内の最高値 - 現在の終値) / (期間内の最高値 - 期間内の最安値) × (-100)

この計算により、値は常に0 ～ -100の範囲で推移します。ここが他のオシレーターと少し違うポイントで、値がマイナスの範囲で動くことを覚えておきましょう。

値の見方

• 0 に近い（-20より上）：買われすぎゾーン → 売りシグナルの候補
• -100 に近い（-80より下）：売られすぎゾーン → 買いシグナルの候補
• -50 付近：中立的な状態

ストキャスティクスと非常に似た性質を持っていますが、ウィリアムズ%Rはスケールが反転している点が特徴です。ストキャスティクスでは値が高いほど買われすぎですが、ウィリアムズ%Rでは値が0に近いほど買われすぎとなります。

iWPR関数の構文

MQL4でウィリアムズ%Rの値を取得するには、iWPR関数を使います。構文は以下のとおりです。

double iWPR(
    string symbol,      // 通貨ペア名
    int    timeframe,   // 時間足
    int    period,      // 計算期間
    int    shift        // シフト（何本前のバーか）
);

引数の詳細

戻り値はdouble型で、0 ～ -100 の範囲の値が返されます。

基本的な使い方

まずは、iWPR関数で値を取得してログに出力するシンプルな例を見てみましょう。

void OnTick()
{
    // 現在のチャート、現在の時間足、期間14、1本前の確定バーのウィリアムズ%Rを取得
    double wpr = iWPR(NULL, 0, 14, 1);

    // エキスパートログに出力
    Print("Williams %%R (1本前) = ", DoubleToString(wpr, 2));

    // 買われすぎ・売られすぎの判定
    if(wpr > -20)
    {
        Print("→ 買われすぎゾーン");
    }
    else if(wpr < -80)
    {
        Print("→ 売られすぎゾーン");
    }
    else
    {
        Print("→ 中立ゾーン");
    }
}

ここでshift に 1 を指定している点がポイントです。shift=0 だと現在まだ形成中のバーの値を取得してしまい、リアルタイムで値が変動します。EA開発では、確定したバー（shift=1）の値を使うのが基本です。

サンプル①：買われすぎ・売られすぎの状態をチャートに表示する

次に、ウィリアムズ%Rの状態をチャートのコメントとしてリアルタイム表示するコードを作ってみましょう。

// ウィリアムズ%Rの状態表示スクリプト
extern int WPR_Period = 14;          // 計算期間
extern double OverBought = -20.0;    // 買われすぎライン
extern double OverSold   = -80.0;    // 売られすぎライン

void OnTick()
{
    double wprCurrent = iWPR(NULL, 0, WPR_Period, 0);
    double wprPrev    = iWPR(NULL, 0, WPR_Period, 1);

    string status = "";

    if(wprPrev > OverBought)
        status = "★ 買われすぎゾーン（売りに注目）";
    else if(wprPrev < OverSold)
        status = "★ 売られすぎゾーン（買いに注目）";
    else
        status = "― 中立ゾーン";

    Comment(
        "===== Williams %R Monitor =====\n",
        "期間: ", WPR_Period, "\n",
        "現在値 (形成中): ", DoubleToString(wprCurrent, 2), "\n",
        "確定値 (1本前) : ", DoubleToString(wprPrev, 2), "\n",
        "状態: ", status, "\n",
        "================================"
    );
}

このコードをEAとしてチャートにセットすると、左上にウィリアムズ%Rの値と状態がリアルタイムで表示されます。動きを観察しながら指標の特性を学ぶのに最適です。

サンプル②：ゾーン脱出型シグナルのシンプルEA

ウィリアムズ%Rを使ったEAを作る際、単純に「-80以下で買い」とするとダマシが多くなります。そこで、ゾーン脱出型の考え方を取り入れます。

ゾーン脱出型とは、以下のようなロジックです。

• 買いシグナル：売られすぎゾーン（-80以下）に入った後、-80を上回って脱出したとき
• 売りシグナル：買われすぎゾーン（-20以上）に入った後、-20を下回って脱出したとき

これにより、ゾーン内に張り付いたまま反転しないケースのダマシを軽減できます。

// ゾーン脱出型 ウィリアムズ%R EA
extern int    WPR_Period  = 14;
extern double LotSize     = 0.01;
extern double OverBought  = -20.0;
extern double OverSold    = -80.0;
extern int    StopLoss    = 100;     // ストップロス（pips）
extern int    TakeProfit  = 200;     // テイクプロフィット（pips）
extern int    MagicNumber = 12345;

void OnTick()
{
    // 新しいバーが確定したときだけ処理する
    static datetime lastBarTime = 0;
    if(Time[0] == lastBarTime) return;
    lastBarTime = Time[0];

    // 確定バーと、その1つ前のバーのウィリアムズ%Rを取得
    double wpr1 = iWPR(NULL, 0, WPR_Period, 1);  // 直近の確定バー
    double wpr2 = iWPR(NULL, 0, WPR_Period, 2);  // その1つ前

    // 既存ポジションの確認
    int posCount = 0;
    for(int i = OrdersTotal() - 1; i >= 0; i--)
    {
        if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES))
        {
            if(OrderSymbol() == Symbol() && OrderMagicNumber() == MagicNumber)
                posCount++;
        }
    }

    // ポジションがない場合のみエントリー判定
    if(posCount > 0) return;

    double sl, tp;

    // 買いシグナル：売られすぎゾーンから脱出
    if(wpr2 < OverSold && wpr1 >= OverSold)
    {
        sl = Ask - StopLoss * Point * 10;
        tp = Ask + TakeProfit * Point * 10;
        int ticket = OrderSend(Symbol(), OP_BUY, LotSize, Ask, 3, sl, tp,
                               "WPR Buy Signal", MagicNumber, 0, clrBlue);
        if(ticket > 0)
            Print("買いエントリー: WPR=", DoubleToString(wpr1, 2));
        else
            Print("買い注文エラー: ", GetLastError());
    }

    // 売りシグナル：買われすぎゾーンから脱出
    if(wpr2 > OverBought && wpr1 <= OverBought)
    {
        sl = Bid + StopLoss * Point * 10;
        tp = Bid - TakeProfit * Point * 10;
        int ticket = OrderSend(Symbol(), OP_SELL, LotSize, Bid, 3, sl, tp,
                               "WPR Sell Signal", MagicNumber, 0, clrRed);
        if(ticket > 0)
            Print("売りエントリー: WPR=", DoubleToString(wpr1, 2));
        else
            Print("売り注文エラー: ", GetLastError());
    }
}

このEAのポイントは以下のとおりです。

• 新しいバー確定時のみ判定：static変数でバーの時刻を管理し、同じバーで何度も判定しない
• ゾーン脱出の判定：2本前がゾーン内、1本前がゾーン外になったことで「脱出」を検知
• ポジション制限：同時に1ポジションのみ持つようにしている

サンプル③：移動平均線との組み合わせ（トレンドフィルター付きEA）

オシレーター系指標の弱点は、強いトレンドが発生している局面では買われすぎ・売られすぎの状態が長く続き、シグナルが機能しにくいことです。

これを改善するために、移動平均線によるトレンドフィルターを追加したEAを作ってみましょう。

// トレンドフィルター付き ウィリアムズ%R EA
extern int    WPR_Period  = 14;
extern int    MA_Period   = 50;      // 移動平均線の期間
extern int    MA_Method   = MODE_SMA; // 移動平均の種類
extern double LotSize     = 0.01;
extern double OverBought  = -20.0;
extern double OverSold    = -80.0;
extern int    StopLoss    = 100;
extern int    TakeProfit  = 200;
extern int    MagicNumber = 12346;

void OnTick()
{
    // 新しいバー確定時のみ処理
    static datetime lastBarTime = 0;
    if(Time[0] == lastBarTime) return;
    lastBarTime = Time[0];

    // ウィリアムズ%Rの値を取得
    double wpr1 = iWPR(NULL, 0, WPR_Period, 1);
    double wpr2 = iWPR(NULL, 0, WPR_Period, 2);

    // 移動平均線の値を取得
    double ma1 = iMA(NULL, 0, MA_Period, 0, MA_Method, PRICE_CLOSE, 1);

    // 現在の価格と移動平均線の位置関係でトレンドを判定
    double closePrice = Close[1];
    bool isUpTrend   = (closePrice > ma1);  // 上昇トレンド
    bool isDownTrend = (closePrice < ma1);  // 下降トレンド

    // 既存ポジションの確認
    int posCount = 0;
    for(int i = OrdersTotal() - 1; i >= 0; i--)
    {
        if(OrderSelect(i, SELECT_BY_POS, MODE_TRADES))
        {
            if(OrderSymbol() == Symbol() && OrderMagicNumber() == MagicNumber)
                posCount++;
        }
    }

    if(posCount > 0) return;

    double sl, tp;

    // 買いシグナル：上昇トレンド中 + 売られすぎゾーンから脱出
    if(isUpTrend && wpr2 < OverSold && wpr1 >= OverSold)
    {
        sl = Ask - StopLoss * Point * 10;
        tp = Ask + TakeProfit * Point * 10;
        int ticket = OrderSend(Symbol(), OP_BUY, LotSize, Ask, 3, sl, tp,
                               "WPR+MA Buy", MagicNumber, 0, clrBlue);
        if(ticket > 0)
            Print("買いエントリー（トレンドフィルター付き）: WPR=",
                  DoubleToString(wpr1, 2), " MA=", DoubleToString(ma1, 5));
    }

    // 売りシグナル：下降トレンド中 + 買われすぎゾーンから脱出
    if(isDownTrend && wpr2 > OverBought && wpr1 <= OverBought)
    {
        sl = Bid + StopLoss * Point * 10;
        tp = Bid - TakeProfit * Point * 10;
        int ticket = OrderSend(Symbol(), OP_SELL, LotSize, Bid, 3, sl, tp,
                               "WPR+MA Sell", MagicNumber, 0, clrRed);
        if(ticket > 0)
            Print("売りエントリー（トレンドフィルター付き）: WPR=",
                  DoubleToString(wpr1, 2), " MA=", DoubleToString(ma1, 5));
    }
}

このEAでは、以下のフィルタリングを行っています。

• 買いエントリー：価格が移動平均線より上（上昇トレンド）のときだけ、売られすぎからの脱出シグナルを採用
• 売りエントリー：価格が移動平均線より下（下降トレンド）のときだけ、買われすぎからの脱出シグナルを採用

こうすることで、トレンド方向と逆行するエントリーを防ぎ、勝率の向上が期待できます。

iWPR関数を使う際の注意点

1. 値の範囲はマイナスである

ウィリアムズ%Rの値は0 ～ -100です。RSIのように0～100ではないので、条件式を書くときに符号を間違えないよう注意してください。例えば「-80以下」は wpr < -80 と書きます。

2. トレーディングスタイルに合わせた期間設定

ウィリアムズ%Rの計算期間は、トレーディングスタイルに合わせて調整するのがおすすめです。

3. 強いトレンド相場には注意

オシレーター系指標全般に言えることですが、強い上昇トレンドや下降トレンドでは、ウィリアムズ%Rが買われすぎ・売られすぎゾーンに張り付いたまま動かないことがあります。このような場合、逆張りシグナルが機能しません。サンプル③のようにトレンドフィルターと組み合わせることを強くおすすめします。

4. 確定バーの値を使う

EA開発では、形成中のバー（shift=0）ではなく、確定したバー（shift=1以上）の値を使うのが鉄則です。形成中のバーの値はティックごとに変動するため、シグナルがチラつく原因になります。

まとめ

この記事では、MQL4のiWPR関数を使ってウィリアムズ%Rの値を取得し、EA開発に活用する方法を解説しました。最後にポイントをおさらいしましょう。

• iWPR関数は4つの引数（symbol, timeframe, period, shift）を指定してウィリアムズ%Rの値を取得する
• 値の範囲は0 ～ -100で、-20以上が買われすぎ、-80以下が売られすぎ
• ゾーン脱出型のシグナルにすることで、単純なゾーン判定よりダマシを軽減できる
• 移動平均線などのトレンドフィルターと組み合わせることで、さらに精度を高められる
• EA開発では必ず確定バー（shift=1）の値を使うこと

ウィリアムズ%Rはシンプルな指標ですが、正しく使えばエントリーポイントの精度を上げる強力な武器になります。まずはサンプルコードをストラテジーテスターで動かして、動作を確認するところから始めてみてください！

投稿 【MQL4】iWPR関数の使い方を徹底解説！ウィリアムズ%Rでエントリーシグナルを作ろう は 自動売買を作ろう！ に最初に表示されました。