既刊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で実際に動かす手順
- MT4の「ツール」→「MetaQuotes Language Editor」でMetaEditorを開く
- 「ファイル」→「新規作成」→「カスタムインジケーター」を選び、名前を「RangePercentileIndicator」にして作成する
- テンプレートの中身を全て削除し、上のコードを丸ごと貼り付ける
- F7キー(またはコンパイルボタン)でコンパイルし、「0 error(s), 0 warning(s)」になることを確認する
- 日足チャートへドラッグ&ドロップし、左上のコメント欄に「本日の値幅の順位は過去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点です。
今日の値幅が過去何番目に近いかを判定するような、
「相対的な位置」を知りたい場面で活用できます。
くわしい自動化の開示方針は編集方針ページもご覧ください。
コメント