この記事を開いてくださったこと、心から感謝しています。直近の足の中で、いちばん高い値がどこにあるのかを調べたいと考えている人も、きっと多いはずです。
結論から言うと、チャートの足を対象にするならiHighest、自分で用意した配列を対象にするならArrayMaximumです。調べる相手が違う関数です。
また、同じ値が並んだときにどの位置が返るかなど、確認した公式ページに書かれていない点もありました。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、番号の数え方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
iHighestとArrayMaximumは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも、いちばん大きい値の位置を返しますが、調べる相手が入れ替わっています。
iHighestは、チャートの足の中から探す関数である
iHighestは、銘柄の名前、時間足、調べる項目、本数、開始位置を渡すと、いちばん高い値の足の番号を返す関数です。番号は、いまの足からの位置で表されます。
調べる項目には、終値などの種類を指定します。つまり、配列を自分で用意しなくても、チャートの足そのものから、直接探せます。
- 銘柄と時間足を渡す
- 終値などの項目を指定する
- 足の番号が、戻り値で返る
ArrayMaximumは、配列の中から探す関数である
ArrayMaximumは、数値の配列、開始位置、個数を渡すと、いちばん大きい要素の番号を返す関数です。配列は、自分で用意したものでも、価格を取り込んだものでも使えます。
公式の説明では、多次元の配列も受け取れますが、探すのは、いつも最初の次元だけです。配列の作り方に、制限は少ない関数です。
- 配列を渡す
- 開始位置と個数を指定する
- いちばん大きい要素の番号が返る
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | iHighest | ArrayMaximum |
|---|---|---|
| 調べる相手 | チャートの足 | 数値の配列 |
| 失敗したときの値 | -1 | -1 |
| GetLastErrorの案内 | ある | 記載なし |
| 番号の数え方 | いまの足から | 配列の向きの設定に従う |
| 同じ値が並んだとき | 記載なし | 記載なし |
| テスターでの動き | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
iHighestは、どんな場面で使うのか?
iHighestは、チャートの足の中で、いちばん高い値の位置を、手早く知りたいときに使います。公式の説明から、動き方を確認します。
本数と開始位置で、調べる範囲を決める
四つ目の引数は本数、五つ目の引数は開始位置です。本数を省略すると、全体が対象になります。開始位置を省略すると、いまの足から始まります。
公式の例では、開始位置が4、本数が20です。この場合、4番の足から、20本が調べられます。いまの足を除いて探したいときに、便利な書き方です。
- 本数は、省略すると全体になる
- 開始位置は、省略すると0
- 公式の例は、4番から20本
開始位置に負の数を渡すと、0になる
公式の説明では、開始位置に負の数を渡すと、無視されて、0に置き換えられます。エラーにはならないと読み取れますが、その点を明記した記述は、見つかりませんでした。
負の数をわざと渡す使い方は、おすすめできません。開始位置は、0以上の数で、はっきり指定する書き方が安心です。
- 負の数は、0に置き換わる
- エラーになるかは、記載なし
- 0以上で、はっきり指定する
失敗したときは、-1が返る
iHighestは、失敗すると-1を返します。詳しい原因は、GetLastErrorで調べるよう、公式で案内されています。具体的なエラー番号の一覧は、記載なしでした。
本数が足の数より多いときや、開始位置が範囲を超えたときの動きは、公式のページに書かれていません。-1を、そのまま番号として使わないよう、確認を足しておきましょう。
- 失敗すると、-1が返る
- 原因は、GetLastErrorで調べる
- 範囲外の指定の動きは、記載なし
公式サンプルには、気になる点がある
公式サンプルは、終値でいちばん高い位置を探したあと、その番号で、高値を読んでいます。コメントは終値の最高値と書かれていますが、読んでいるのは高値です。意図した書き方かどうかは、説明がありません。
また、サンプルは断片のため、高値の配列が宣言されていません。そのまま貼り付けても動かないので、自分で、必要な部分を補う必要があります。
- コメントと、読む値が食い違う
- 高値の配列の宣言が、載っていない
- そのままでは動かない
ArrayMaximumは、どんな場面で使うのか?
ArrayMaximumは、すでに手元にある配列の中で、いちばん大きい要素の位置を知りたいときに使います。公式の説明から、動き方を確認します。
配列の向きの設定が、結果に影響する
公式の注意書きには、探すときに、AS_SERIESという旗の値が考慮される、と書かれています。この旗は、配列の番号を、新しい順にするか、古い順にするかを決めるものです。
そのため、同じ値の並びでも、旗の設定が違えば、返る番号が変わる可能性があります。使う前に、配列の向きを確かめておくのが安心です。
- AS_SERIESの旗が、考慮される
- 向きが違えば、番号も変わりうる
- 使う前に、向きを確かめる
多次元でも、探すのは最初の次元だけである
公式の注意書きには、どんな次元の配列でも受け取れるが、探すのは、いつも最初の次元だけ、と書かれています。二次元の配列では、探す対象が限られます。
ただし、行ごとの比べ方が、どう決まるのかは、公式のページに書かれていません。多次元の配列で使うときは、小さな例で、結果を確かめてから使いましょう。
- 探すのは、最初の次元だけ
- 行の比べ方は、記載なし
- 小さな例で、確かめる
失敗したときは、-1が返る
ArrayMaximumも、失敗すると-1を返します。ただし、公式のページには、GetLastErrorで調べるといった案内が、見つかりませんでした。エラーが記録されるかどうかは、記載なしです。
空の配列や、範囲外の開始位置を渡したときの動きも、公式のページには書かれていません。使う前に、配列の大きさを確かめる書き方が安心です。
- 失敗すると、-1が返る
- GetLastErrorの案内は、記載なし
- 空の配列の動きは、記載なし
2つの関数は、同じ結果になるのか?
チャートの足から取った値を配列に入れれば、どちらでも探せそうに見えます。公式の説明をもとに、分かることと、分からないことを整理します。
番号の数え方は、そろえて考える必要がある
iHighestの番号は、いまの足からの位置です。一方、ArrayMaximumの番号は、配列の向きの設定に従います。そのため、2つの番号を、そのまま見比べることはできません。
取り込んだ価格の配列を、新しい順にそろえておけば、足の番号と同じ向きになります。足の情報を配列に取り込む方法は、iBarShiftとiTimeの記事でも触れた、足の番号の考え方と合わせて確かめてください。
- iHighestは、いまの足から数える
- ArrayMaximumは、配列の向きに従う
- 向きをそろえてから、見比べる
同じ値が並んだとき、どれが返るかは記載がない
最大の値が、複数の足に並んだとき、最初の位置が返るのか、最後の位置が返るのかは、2つとも、公式のページに書かれていません。
結果が変わると困る場面では、自分の環境で、同じ値が並ぶ例を作って確かめておきましょう。2つの関数が、同じ番号を返すかどうかも、記載なしです。
- 同じ値のときの位置は、記載なし
- 2つが一致するかも、記載なし
- 例を作って、確かめる
どう使い分ければよいのか?
チャートの足を直接調べるならiHighest、手元の配列を調べるならArrayMaximumです。調べたい相手が、何かで決まります。
チャートの足を調べるなら、iHighestを選ぶ
直近の何本かの中で、いちばん高い足を探したいときは、iHighestが向いています。配列を用意する手間がなく、短く書けます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
手元の配列を調べるなら、ArrayMaximumを選ぶ
すでに配列に入っている値を、そのまま調べたいときは、ArrayMaximumが向いています。価格以外の数値の配列にも使えます。
- 配列の中を、調べたい
- 価格以外の数値も、調べたい
- 配列の向きを、確かめて使う
最小値を探したいときは、対になる関数がある
公式のページには、最小値を探す関数への案内も載っています。iHighestの関連項目にはiLowest、ArrayMaximumの関連項目にはArrayMinimumがあります。
最大値と最小値の使い方は、よく似ていると考えられますが、細かな違いは、公式のページを読んで、確かめてから使いましょう。
- iHighestの対は、iLowest
- ArrayMaximumの対は、ArrayMinimum
- 細かな違いは、公式で確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、値を表示して確かめるのが安心です。
まずは、iHighestで番号を表示する
最初は、いまのチャートの銘柄と時間足で、終値のいちばん高い足の番号を、ログに出します。-1が返ってきたときは、指定を見直します。
- いまのチャートで、番号を表示する
- -1なら、指定を見直す
- ログで、結果を確かめる
次に、配列に取り込んで、ArrayMaximumで確かめる
次に、同じ範囲の終値を配列に取り込み、ArrayMaximumで番号を求めます。配列の向きをそろえてから、iHighestの番号と見比べます。
- 同じ範囲を、配列に取り込む
- 配列の向きを、そろえる
- 2つの番号を、見比べる
最後に、同じ値が並ぶ例でも試す
同じ値が並んだときの位置は、公式に記載がありません。そのため、自分の環境で、同じ値が並ぶ例を作って、結果を見ておくと、安心して使えます。









- まず、番号を表示する
- 次に、配列で確かめる
- 最後に、同じ値の例で試す
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
どちらも、失敗すると-1が返るのか?
はい、公式の説明では、2つとも失敗すると-1を返します。ただし、GetLastErrorで調べる案内があるのは、iHighestだけです。
- どちらも、失敗は-1
- GetLastErrorの案内は、iHighestだけ
本数を省略すると、どうなるのか?
どちらも、本数を省略すると、全体が対象になります。公式では、この既定値をWHOLE_ARRAYと呼んでいます。この値が、具体的にいくつなのかは、記載なしでした。
- 省略すると、全体が対象
- WHOLE_ARRAYの数値は、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のiHighestとArrayMaximum、チャートの足から最高値の位置をすぐ探せる手軽さと自分で用意した配列の中から大きい値の位置を探せる自由さどっちを選ぶ?」
チャートの足を直接調べるならiHighest、自分で用意した配列を調べるならArrayMaximumです。どちらも、記載のない点は自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










