既刊mql4-array-functions.mdでは、

配列のサイズ変更・複製・時系列扱いの3関数を解説しました。

既刊arraymaximum-arrayminimum-mt4.mdでは、

配列から最大値・最小値のインデックスを1件だけ探す方法を解説しました。

ですが、「配列そのものを並べ替える」、

「並べ替えた配列から目的の値に近い順位を探す」という使い方は、

まだどちらの記事でも扱っていませんでした。

この記事では、`ArraySort()`で過去N日分の値幅(pips)を並べ替え、

`ArrayBsearch()`で、

「今日の値幅は過去何番目に近いか」を判定するインジケーターを例に、

2つの関数の使い方を解説します。

ArraySort/ArrayBsearchは何を解決する関数なのか

まず、既刊の配列関数群との役割分担を整理します。

既刊ArrayMaximum/ArrayMinimumとの違い

ArrayMaximum/ArrayMinimumの記事で解説した2関数は、

配列全体を1回だけ線形に調べ、

最大値または最小値の「インデックスを1件」返す関数でした。

この記事が解決する範囲:並べ替えと順位検索

本記事の`ArraySort()`は、

配列そのものの要素の並び順を書き換える関数、

`ArrayBsearch()`は、

並べ替え済みの配列から、

指定した値に最も近い要素の「順位(インデックス)」を高速に探す関数です。

この記事で作るもの: 過去30日分の日足値幅(pips)を配列に記録し、

`ArraySort()`で並べ替えます。

`ArrayBsearch()`で、今日の値幅が過去30日中の何番目に近いかを判定し、

パーセンタイルとして表示するインジケーターを作ります。

ArraySort()のシグネチャと並べ替えの仕様

ここから、1つ目の関数を見ていきます。

シグネチャ全文

公式リファレンス(ArraySort)によると、シグネチャは次の通りです。

bool ArraySort(
   void& array[],          //並べ替えたい数値配列
   int   count=WHOLE_ARRAY, //並べ替える要素数
   int   start=0,           //開始インデックス
   int   direction=MODE_ASCEND //MODE_ASCEND(昇順)またはMODE_DESCEND(降順)
  );

数値配列の第1次元が対象

公式リファレンスには、

数値配列(numeric arrays)の第1次元でソートする関数と明記されています。

文字列配列(string[])への適用は明記が無いため、

本記事では数値配列限定として扱います。

用語: 「第1次元」とは、2次元配列`array[10][3]`であれば、

先頭の`[10]`側の並び順が入れ替わるという意味です。

各行の中身(`[3]`側)はそのまま、行単位で並び替わります。

落とし穴:AS_SERIESフラグが並べ替えに影響する

注意: 公式リファレンスには、

「AS_SERIESフラグが並べ替えの際に考慮される」と明記されています。

既刊mql4-array-functions.mdの、

`ArraySetAsSeries(true)`を、

適用済みの配列に対して`ArraySort()`を呼ぶと、

添字の数え方が時系列基準のまま並べ替わるため、

結果の解釈を誤りやすくなります。

並べ替え結果を単純な昇順インデックスとして扱いたい場合は、

`ArraySetAsSeries(array, false)`を、

先に呼んでおくことをおすすめします。

落とし穴:並べ替える前に元の配列をコピーしておく

`ArraySort()`には、もう1つ注意点があります。

ArraySortは配列を直接書き換える

`ArraySort()`は、

渡した配列そのものの要素の並び順を書き換えます。

元の時系列順(何日前のデータか)をどこかで使い続ける場合、

並べ替える前に別の配列へ複製しておく必要があります。

既刊ArrayCopyで複製してから並べ替える

ArrayCopyの記事で解説した通り、

`ArrayCopy()`で配列を複製できます。

double sortedRanges[];
ArrayCopy(sortedRanges, rangeHistory); //元の時系列配列はそのまま残す
ArraySort(sortedRanges);               //複製した方だけ並べ替える

ArrayBsearch()のシグネチャと二分探索の前提

並べ替えた配列から、目的の値を探します。

シグネチャ全文

公式リファレンス(ArrayBsearch)によると、シグネチャは次の通りです。

int ArrayBsearch(
   const double& array[],       //事前にソート済みの数値配列
   double        value,         //探したい値
   int           count=WHOLE_ARRAY,
   int           start=0,
   int           direction=MODE_ASCEND
  );

前提:配列は事前にソート済みでなければならない

注意: 公式リファレンスには、

「二分探索は、ソート済みの配列のみを処理する。

数値配列をソートするにはArraySort()関数を使うこと」と明記されています。

`ArraySort()`を呼ばずに`ArrayBsearch()`だけを使うと、

正しくない順位を返す恐れがあります。

完全一致しない場合は「最も近い値」を返す仕様

公式リファレンスには、

探している値が配列内に完全一致しない場合、

「最も近い値を持つ要素のインデックス」を返すと明記されています。

この仕様を逆に活用する: 今日の値幅が、

過去30日のどの値とも完全一致することはまずありません。

この「最も近い値」を返す仕様のおかげで、

完全一致を気にせずそのまま順位(パーセンタイル)を算出できます。

実際に動くコード全体:今日の値幅の過去30日パーセンタイル表示

ここまでの要素をまとめた、実際にMetaEditorでコンパイルできるコードです。

//+------------------------------------------------------------------+
//|                                   RangePercentileIndicator.mq4    |
//|                     Copyright 2026, FX-EA System Project Creator |
//|                        https://creator.fx-ea-system-project.com/ |
//+------------------------------------------------------------------+
#property copyright "Copyright 2026, FX-EA System Project Creator"
#property link      "https://creator.fx-ea-system-project.com/"
#property version   "1.00"
#property strict
#property indicator_chart_window

input int InpLookbackDays = 30;//パーセンタイルの基準にする過去日数

//+------------------------------------------------------------------+
//| 直近InpLookbackDays本の日足値幅(pips)を配列へ格納する(当日分は除く)     |
//+------------------------------------------------------------------+
int BuildRangeHistory(double &rangeHistory[])
  {
   ArrayResize(rangeHistory, InpLookbackDays);
   int filled = 0;
   for(int i = 1; i <= InpLookbackDays; i++)
     {
      double high = iHigh(NULL, PERIOD_D1, i);
      double low  = iLow(NULL, PERIOD_D1, i);
      if(high == 0 || low == 0)
         continue; //ヒストリーが無い日はスキップ
      rangeHistory[filled] = (high - low) / Point;
      filled++;
     }
   ArrayResize(rangeHistory, filled);
   return(filled);
  }

//+------------------------------------------------------------------+
//| 今日の値幅が過去何パーセンタイルの位置にあるかを計算する                 |
//+------------------------------------------------------------------+
double CalcTodayPercentile()
  {
   double rangeHistory[];
   int count = BuildRangeHistory(rangeHistory);
   if(count < 2)
      return(-1);

   double sortedRanges[];
   ArrayCopy(sortedRanges, rangeHistory); //元の時系列配列は使わないが設計として明示的に複製
   ArraySort(sortedRanges);               //昇順に並べ替え(複製した方だけ)

   double todayRange = (iHigh(NULL, PERIOD_D1, 0) - iLow(NULL, PERIOD_D1, 0)) / Point;
   int rank = ArrayBsearch(sortedRanges, todayRange);

   return(100.0 * rank / (count - 1));
  }

//+------------------------------------------------------------------+
//| Custom indicator initialization function                          |
//+------------------------------------------------------------------+
int OnInit()
  {
   return(INIT_SUCCEEDED);
  }

//+------------------------------------------------------------------+
//| Custom indicator iteration function                                |
//+------------------------------------------------------------------+
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[])
  {
   double percentile = CalcTodayPercentile();
   if(percentile >= 0)
      Comment(StringFormat("本日の値幅の順位は過去%d日中%.0f%%タイル(100%%に近いほど広い)", InpLookbackDays, percentile));
   return(rates_total);
  }
//+------------------------------------------------------------------+

MetaEditorで実際に動かす手順

  1. MT4の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
  2. 「ファイル」→「新規作成」→「カスタムインジケーター」を選び、名前を「RangePercentileIndicator」にして作成する
  3. テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
  4. F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
  5. 日足チャートへドラッグ&ドロップし、左上のコメント欄に「本日の値幅の順位は過去30日中◯%タイル」と表示されることを確認する

コピペしてコンパイルが通らない・値がおかしいときに確認すること

  • コンパイルエラーになる: `ArraySort()`・`ArrayBsearch()`ともに数値配列専用のため、文字列配列(string[])に対して呼んでいないか確認する
  • パーセンタイルが常に0%か100%になる: `ArraySort()`を呼ぶ前に`ArrayBsearch()`を実行していないか、呼び出し順を確認する(本記事の落とし穴)
  • 値幅の履歴が極端に少ない: チャートに表示されている日足のヒストリーの本数が`InpLookbackDays`に足りているか確認する(ヒストリーセンターでの読み込みが必要な場合がある)
  • 数値が時系列と逆に見える: `ArraySetAsSeries()`を適用した配列に対してそのまま`ArraySort()`を呼んでいないか確認する(本記事の落とし穴)

よくある質問

ArraySort/ArrayBsearchについて、

よく検索されている疑問を3つにまとめて回答します。

降順で並べ替えて降順のまま検索できますか?

できます。`ArraySort()`・`ArrayBsearch()`ともに、

`direction`引数に`MODE_DESCEND`を渡すことで、

降順のまま並べ替え・検索の両方に対応しています。

ただし両方の関数で同じ`direction`を指定する必要があります。

ArrayMaximum/ArrayMinimumで十分な場合はどちらを使うべきですか?

「配列全体の最大値・最小値を1件だけ知りたい」のであれば、

既刊ArrayMaximum/ArrayMinimumの記事の方が、

並べ替えが不要な分シンプルです。

「任意の値が全体の中で何番目に近いか」を知りたい場合に、

本記事のArraySort/ArrayBsearchが向いています。

文字列配列(string[])も並べ替えられますか?

公式リファレンスには数値配列(numeric arrays)としか明記が無く、

文字列配列への適用は確認できていません。

文字列を並べ替えたい場合は、

自分でソートアルゴリズムを実装する必要があります。

このパーセンタイルは統計的に厳密な値ですか?

厳密ではありません。本記事の`CalcTodayPercentile()`は、

`ArrayBsearch()`が返した順位を件数で割っただけの簡略値であり、

統計学で使われる補間計算は行っていません。

「過去と比べて相対的に大きいか小さいか」の目安として使ってください。

【MQL4】ArraySort・ArrayBsearchで『今日の値幅は過去何番目か』を判定する方法について解説してみた(ArrayMaximum/ArrayMinimumとの違い):まとめ

この記事では、既刊ArrayMaximum/ArrayMinimumの記事で、

扱わなかった、

「配列を並べ替える」`ArraySort()`と、

「並べ替えた配列から最も近い値の順位を探す」、

`ArrayBsearch()`を解説しました。

ポイントは、`ArraySort()`は配列を直接書き換えるため、

元の時系列順が必要なら先に`ArrayCopy()`で複製すること、

`ArrayBsearch()`は事前にソート済みの配列しか正しく扱えないことの2点です。

今日の値幅が過去何番目に近いかを判定するような、

「相対的な位置」を知りたい場面で活用できます。

くわしい自動化の開示方針は編集方針ページもご覧ください。

関連記事