この記事を開いてくださったこと、心から感謝しています。数値の配列を並べ替えたいのか、配列の中から値を探したいのか、迷っている人も、きっと多いはずです。
結論から言うと、数値の配列を小さい順に並べ替えたいときはArraySort、並べ替えた配列から値の位置を探したいときはArrayBsearchです。2つは役目が違い、組み合わせて使う前提で説明されています。
また、確認した公式ページに書かれていない点もありました。たとえば、エラーコードや、同じ値が複数あるときの動きです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ArraySortとArrayBsearchは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも数値の配列を扱いますが、やることが違います。
ArraySortは、配列を小さい順に並べ替える関数である
ArraySortは、数値の配列を1つ渡すと、その配列そのものを小さい順に並べ替える関数です。多次元の配列では、第1次元の値が並べ替えられます。
戻り値は、成功ならtrue、失敗ならfalseです。公式のページには、エラーコードは書かれていません。
- 数値の配列を1つ渡す
- 配列そのものが並べ替えられる
- 戻り値は、trueかfalse
ArrayBsearchは、並べ替えた配列から値の位置を探す関数である
ArrayBsearchは、並べ替え済みの数値の配列と、探したい値を渡すと、その位置を返す関数です。二分探索という方法を使うため、小さい順に並んだ配列にだけ使えます。
値が見つからないときは、いちばん近い値の位置が返る、と説明されています。-1のような、見つからないことを表す戻り値は、書かれていません。
- 並べ替え済みの配列と、探す値を渡す
- 位置が、整数で返る
- 見つからないときは、近い値の位置が返る
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ArraySort | ArrayBsearch |
|---|---|---|
| 主な役目 | 小さい順に並べ替える | 値の位置を探す |
| 渡すもの | 数値の配列 | 並べ替え済みの配列と値 |
| 戻り値 | trueかfalse | 位置の番号 |
| 見つからないとき | 該当なし | 近い値の位置が返る |
| エラーコード | 記載なし | 記載なし |
| テスターでの動き | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ArraySortは、どんな場面で使うのか?
ArraySortは、数値を小さい順に並べて、順番に意味を持たせたいときに使います。公式の説明から、動き方を確認します。
並べ替えは、いつも小さい順である
公式には、AS_SERIESの設定がどうであっても、いつも小さい順に並べ替える、と書かれています。時系列の向きの設定は、並べ替えの向きには影響しません。
大きい順に並べ替えるための指定は、このページには書かれていません。大きい順が必要な場合の方法は、公式のこのページだけでは分かりません。
- 並べ替えは、小さい順だけ
- AS_SERIESの設定に影響されない
- 大きい順の指定は、記載なし
多次元の配列では、第1次元だけが対象になる
公式には、ArraySortもArrayBsearchも、どの次元の配列でも受け取れるが、並べ替えと探索は、第1次元に対して行われる、と書かれています。
そのため、2次元以上の配列を使うときは、どの値が並べ替えの対象になるのかを、事前に確かめておくと安心です。第2次元以降の値の動きは、このページには書かれていません。
- 対象は、第1次元だけ
- 第2次元以降の動きは、記載なし
- 使う前に、小さな配列で確かめる
公式サンプルは、出来高の境目を求めている
公式サンプルは、直近1か月ほどの出来高を集め、ArraySortで並べ替えてから、小さい側と大きい側の境目の値を取り出しています。その境目で、ローソク足の色分けを決める指標です。
このサンプルは、1次元の配列を使っています。画面に出る文字の出力はなく、結果はチャートに描かれます。多次元の配列を並べ替える場合の動きは、サンプルでは確認できません。
- 出来高を集めて、並べ替える
- 並べ替えた配列から、境目の値を取る
- 結果は、チャートに描かれる
型や同じ値の扱いは、確認できない点が多い
対象は「数値の配列」とだけ書かれていて、使える型の一覧は、載っていません。同じ値が並ぶときの順番や、並べ替えの速さも、記載なしです。
空の配列や、数値でない値が含まれる場合の動きも、書かれていません。大きな配列を扱うときは、時間がかかるかどうかを、自分の環境で確かめましょう。
- 使える型の一覧は、記載なし
- 同じ値の順番は、記載なし
- 空の配列の動きは、記載なし
ArrayBsearchは、どんな場面で使うのか?
ArrayBsearchは、並べ替えた配列の中で、ある値がどのあたりにあるのかを知りたいときに使います。公式の説明から、動き方を確認します。
並べ替えていない配列には使えない
公式には、二分探索は、並べ替え済みの配列だけを処理できる、と書かれています。数値の配列を並べ替えるには、ArraySortを使うように、と案内されています。
並べ替えていない配列に使った場合の動きは、書かれていません。そのため、探す前に、必ず並べ替えておくのが基本です。
- 並べ替え済みの配列だけが対象
- 並べ替えは、ArraySortで行う
- 未整理の配列の動きは、記載なし
型ごとに、6つの形が用意されている
公式には、小数が2種類、整数が4種類の、合計6つの形が載っています。受け取る配列と探す値は、同じ型にそろえる形です。
符号なしの型や、日時の型、色の型などの形は、このページには載っていません。使いたい型があるときは、公式の別のページも、確かめておきましょう。
- 小数は、doubleとfloat
- 整数は、long、int、short、char
- 符号なしの型は、記載なし
見つからないときは、近い値の位置が返る
探した値がないとき、いちばん近い値の位置が返ると説明されています。そのため、返ってきた位置の値が、探した値と同じかどうかは、自分で確かめる必要があります。
同じ値が複数あるときに、どの位置が返るのかや、同じくらい近い値が2つあるときの選び方は、公式には書かれていません。
- 見つからなくても、位置が返る
- 返った位置の値を、確かめる
- 同じ値が複数ある場合は、記載なし
公式サンプルは、RSIの割合を求めている
公式サンプルは、RSIの値を集めて、ArraySortで並べ替えたあと、ArrayBsearchで30と70の位置を探しています。その位置から、売られすぎや買われすぎの範囲に入っていた時間の割合を、計算しています。
RSIの値の集め方は、CopyBufferの記事で整理しています。このサンプルも、画面に出る文字の出力はなく、結果はチャートのラベルに表示されます。
なお、公式の文章は「近い値の位置」としか書かれていないため、サンプルの割合は、位置を境目として見た、おおよその値として読むのが安心です。
- RSIの値を、並べ替える
- 30と70の位置を、探す
- 割合は、おおよその値として読む
どう使い分ければよいのか?
並べ替えたいならArraySort、位置を探したいならArrayBsearchです。ただし、探す前には、並べ替えが必要になります。
順番に意味を持たせたいなら、ArraySortを選ぶ
数値を小さい順に並べて、小さい側や大きい側の境目の値を取りたいときは、ArraySortが向いています。公式サンプルのように、割合で境目を決める使い方もあります。
FX口座・ツールの比較一覧もあわせて確認してみてください。
位置を探したいなら、ArrayBsearchを選ぶ
並べ替え済みの配列で、ある値のあたりの位置を知りたいときは、ArrayBsearchが向いています。見つからなくても位置が返る点は、使うときに覚えておきたいところです。
- 並べ替え済みの配列で使う
- 返った位置の値を、確かめる
- 型を、そろえて渡す
組み合わせて使うのが、基本の形になる
公式サンプルのように、先にArraySortで並べ替えてから、ArrayBsearchで位置を探す、という順番が基本です。順番を逆にすると、探索の前提が崩れます。
- 先に、ArraySortで並べ替える
- 次に、ArrayBsearchで位置を探す
- 返った値を、確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、小さな配列を作って確かめるのが安心です。
まずは、ArraySortの結果を表示する
最初は、数個の数値を並べた配列を作り、ArraySortで並べ替えて、結果をログに出します。戻り値のtrueも、一緒に確かめます。
- 数個の数値で、配列を作る
- 並べ替えて、ログに出す
- 戻り値を、確かめる
次に、ArrayBsearchで値を探してみる
次に、並べ替えた配列から、あるはずの値と、ない値の両方を探します。ない値のときに、どの位置が返るのかを、自分の目で確かめます。
- ある値を探す
- ない値も探す
- 返った位置の値を、表示する
最後に、同じ値を含む配列で試す
最後に、同じ値を複数含む配列で、ArrayBsearchを試します。どの位置が返るのかは、公式に書かれていないため、結果をログで確かめます。









- まず、並べ替えを表示する
- 次に、ある値とない値を探す
- 最後に、同じ値を含めて試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
ArrayBsearchは、並べ替えなしでも使えるのか?
公式には、並べ替え済みの配列だけを処理できる、と書かれています。並べ替えていない配列での動きは、記載なしなので、先に並べ替えておきましょう。
- 並べ替え済みの配列が前提
- 未整理の配列の動きは、記載なし
大きい順に並べ替えたいときは、どうするのか?
公式のArraySortのページには、小さい順にしか並べ替えない、と読み取れる説明があり、大きい順の指定は書かれていません。必要な場合は、別の方法を、自分で確かめることになります。
- 小さい順だけと読み取れる
- 大きい順の指定は、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のArraySortとArrayBsearch、数値配列を並べ替える手軽さと近い値の位置を素早く探せる便利さどっちを選ぶ?」
並べ替えるならArraySort、位置を探すならArrayBsearchです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










