この記事を開いてくださったこと、心から感謝しています。インジケーターを作っていると、配列の並びが新しい順なのか古い順なのか、迷う場面があります。そこで役に立つのが、ArrayIsSeriesとArrayGetAsSeriesです。
結論から言うと、ArrayIsSeriesは、その配列が時系列の配列かどうかを調べる関数で、ArrayGetAsSeriesは、配列に付いている並びの向きの印を読み取る関数です。名前は似ていますが、公式の説明では、見ている対象が少し違います。
また、確認した公式ページには、書かれていない点もありました。たとえば、動的配列と静的配列での違い、多次元配列での動き、GetLastErrorの使い方、サンプルの出力例です。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ArrayIsSeriesとArrayGetAsSeriesは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。どちらも真偽を返し、配列を1つ受け取る形は同じです。
ArrayIsSeriesは、時系列の配列かどうかを調べる関数である
ArrayIsSeriesの形は、bool ArrayIsSeries(const void& array[]) です。引数は調べたい配列で、公式では「Checked array」と説明されています。
戻り値は、調べた配列が時系列の配列なら真、そうでなければ偽です。注意書きの欄は、ありません。
戻り値の説明には、OnCalculateに渡される配列は、要素を読む順番をArrayGetAsSeriesで確かめる、という一文があります。この関数ではなく、もう1つの関数への案内になっています。
- 引数は、調べたい配列を1つ
- 戻り値は、時系列の配列なら真
- 注意書きの欄は、なし
- 動的配列と静的配列の違い:記載なし
ArrayGetAsSeriesは、並びの向きの印を読み取る関数である
ArrayGetAsSeriesの形は、bool ArrayGetAsSeries(const void& array[]) です。引数の名前は、形では array[]、引数の説明の欄では array と書かれていて、少し表記が違います。
戻り値は、その配列にAS_SERIESという印が付いていれば真です。つまり、時系列のように、後ろから前へ読む並びになっていれば、真になります。
公式の注意書きには、2つのことが書かれています。1つは、時系列の配列かどうかを調べるには、ArrayIsSeriesを使うこと。もう1つは、OnCalculateの価格の配列は、時系列と同じ向きとは限らないことです。
- 引数は、読み取りたい配列を1つ
- 戻り値は、AS_SERIESの印が付いていれば真
- 時系列かどうかはArrayIsSeriesで、と注意書きにある
- OnCalculateの配列の向きは、時系列と同じとは限らない
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ArrayIsSeries | ArrayGetAsSeries |
|---|---|---|
| 見るもの | 時系列の配列かどうか | AS_SERIESの印が付いているか |
| 引数 | 配列を1つ(入力) | 配列を1つ(入力) |
| 戻り値 | 時系列なら真 | 印が付いていれば真 |
| 注意書き | なし | あり(2点) |
| GetLastError | 記載なし | 記載なし |
| サンプルの出力 | 記載なし | 画面には出さず、グラフで見せる |
※公式の説明をもとにした、筆者の整理です。
並びの向きは、どう決まるのか?
2つの関数を使い分ける前に、並びの向きの基本を押さえておきます。ここには、並びを変える関数ArraySetAsSeriesも関わります。
時系列は、新しいほうから古いほうへ数える
公式には、時系列は普通の配列と違い、末尾から先頭へ向かって番号が付く、と説明されています。つまり、いちばん新しい値が、番号0になります。
普通の配列は、先頭が0で、順に増えていきます。この違いを知らないと、新しい値を読んでいるつもりで、古い値を読んでしまうことがあります。
- 時系列は、新しいほうから番号が付く
- 普通の配列は、先頭が0で順に増える
- 向きの違いに気づかないと、読む値を取り違える
ArraySetAsSeriesが、向きを切り替える
ArraySetAsSeriesの形は、bool ArraySetAsSeries(const void& array[], bool flag) です。第2引数の真偽で、向きを切り替えます。形のコメントには、真が逆順を表す、と書かれています。
公式の注意書きには、多次元配列と静的配列には、AS_SERIESの印を付けられない、とあります。戻り値は、成功なら真、そうでなければ偽です。
- 第2引数が真で、時系列の向きになる
- 多次元配列には付けられない
- 静的配列にも付けられない
- 戻り値は、成功なら真
ArraySetAsSeriesの説明には、気になる点がある
このページには、読むときに気をつけたい点がありました。説明の文には動的配列と書かれ、引数の説明には数値型の配列と書かれています。
サンプルでは、日時の配列にも使われていますが、数値型に含まれるのかは、書かれていません。また、形はconstなのに、入出力の引数と説明されている点も、少し読みにくいところです。
- 説明の文は動的配列、引数の説明は数値型の配列
- 日時の配列が対象かは、記載なし
- constの形と入出力の説明が、食い違って見える
公式サンプルは、どう読めばよいのか?
2つのサンプルは、どちらもインジケーターの形です。ただし、見せ方がかなり違うので、順に見ていきます。
ArrayIsSeriesのサンプルは、始値の配列を調べている
ArrayIsSeriesのサンプルは、1本のラインを描くインジケーターです。バッファはOnInitで、SetIndexBufferを使って割り当てられています。
OnCalculateの中では、始値の配列に、ArrayIsSeriesを使います。真なら、時系列の配列、偽なら、時系列ではない、という内容を表示する作りです。最後に、rates_totalを返します。
- 1本のラインを描くインジケーター
- バッファはSetIndexBufferで割り当てる
- 始値の配列を調べて、結果を表示する
- 出力例は、記載なし
バッファの割り当てや、配列の向きの扱いは、CopyBufferの記事でも触れています。配列の読み方をおさらいしたいときに、あわせて読んでみてください。
ArrayGetAsSeriesのサンプルは、ローソク足の大きさを描く
ArrayGetAsSeriesのサンプルは、別ウィンドウに棒グラフを描くインジケーターです。入力は2つで、バッファの向きを選ぶ項目と、始値と終値を使うか、高値と安値を使うかを選ぶ項目です。
OnInitで、バッファにArraySetAsSeriesを使い、選んだ向きにします。ラベルは、実体の大きさ、または、ひげの大きさ、になります。色も、それぞれ違います。
計算の部分では、まず、元の配列とバッファに、ArrayGetAsSeriesを使います。時系列の向きなら、ArraySetAsSeriesで、一度、先頭から数える向きに直します。そのうえで、2つの値の差の絶対値を、バッファに入れます。
| 入力 | 選べる内容 | 結果 |
|---|---|---|
| 向きの選択 | 時系列の向き、またはそうでない向き | バッファの向きが変わる |
| 価格の選択 | 始値と終値、または高値と安値 | 実体、またはひげの大きさ |
※公式サンプルのコードをもとにした、筆者の整理です。
サンプルを読むときの注意点がある
2つのサンプルには、細かい表記の揺れがあります。公式のページなので、大きな問題ではありませんが、読むときに気をつけておくと混乱しません。
- 戻り値のコメントがprev_calculatedとなっているが、実際はrates_totalを返している
- ArrayGetAsSeriesのサンプルの説明に、histogramの綴りの誤りがある
- constの引数にArraySetAsSeriesを使っているように見える箇所がある(コンパイルは未確認)
- ArrayIsSeriesの戻り値の説明が、ArrayGetAsSeriesを案内している
このように、公式サンプルは、呼び方を示すのが主な目的で、細かい表記までは整っていません。実際に使うときは、自分で結果を表示して、確かめてください。
どう使い分ければよいのか?
時系列の配列かどうかを知りたいならArrayIsSeries、向きの印を確かめたいならArrayGetAsSeriesです。ただし、公式の説明だけでは、2つの違いが細かく書かれていません。
時系列の配列かを知りたいなら、ArrayIsSeriesを選ぶ
渡された配列が、時系列の配列なのかを知りたいときに使います。戻り値が真か偽だけなので、条件分岐に、そのまま使えます。
FX口座・ツールの比較一覧もあわせて確認してみてください。
並びの向きを確かめたいなら、ArrayGetAsSeriesを選ぶ
要素を読む順番を決める前に、AS_SERIESの印が付いているかを確かめたいときに使います。OnCalculateの配列を扱うときは、公式でもこちらが案内されています。
- AS_SERIESの印の有無を、真偽で返す
- OnCalculateの配列では、こちらが案内されている
- 多次元配列での動きは、記載なし
2つの違いは、公式からは読み切れない部分がある
2つの関数が、同じ配列に対して、違う結果を返す場面があるのかは、確認した公式ページには書かれていません。そのため、どちらを使うかは、自分の環境で確かめるのが安心です。
ここで書いた使い分けは、公式の説明そのものではなく、筆者が整理したものです。迷ったときは、両方を呼んで、結果を並べて表示してみてください。
- 2つの結果が食い違う場面:記載なし
- 迷ったら、両方を呼んで表示して比べる
- 価格データを配列に取り込む流れは、CopyRatesとiCloseの記事も参考になる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、小さなインジケーターを作って、結果を表示するのが安心です。
まずは、価格の配列の向きを表示する
最初は、OnCalculateの中で、始値の配列に2つの関数を呼びます。結果をログに表示して、どちらも同じ結果になるかを見ます。
- 始値の配列に、2つの関数を呼ぶ
- 結果をログに表示する
- 同じ結果になるかを見比べる
次に、ArraySetAsSeriesで向きを変えて確かめる
次に、自分で用意した動的配列に、ArraySetAsSeriesで向きを変えます。変える前と後で、2つの関数の戻り値がどうなるかを、表示して確かめます。
- 動的配列を1つ用意する
- 向きを変える前後で、2つの関数を呼ぶ
- 戻り値を並べて表示する
最後に、静的配列を渡したときを確かめる
最後に、静的配列を渡してみます。公式には、ArraySetAsSeriesで静的配列に印を付けられない、とありますが、2つの関数が静的配列でどう動くかは、書かれていません。









- まず、価格の配列の向きを表示する
- 次に、ArraySetAsSeriesで向きを変えて確かめる
- 最後に、静的配列を渡したときを確かめる
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
2つの関数は、どちらを使えばよいのか?
時系列の配列かを知りたいならArrayIsSeries、AS_SERIESの印を確かめたいならArrayGetAsSeriesです。公式でも、OnCalculateの配列では、後者が案内されています。
- 時系列かどうかは、ArrayIsSeries
- 印の有無は、ArrayGetAsSeries
静的配列や多次元配列でも使えるのか?
2つの関数については、確認した公式ページに、書かれていません。ArraySetAsSeriesの注意書きでは、静的配列と多次元配列には印を付けられない、とあります。
- 2つの関数での動きは、記載なし
- ArraySetAsSeriesでは、付けられない
エラーが起きたときは、GetLastErrorで調べるのか?
確認した3つのページのどれにも、GetLastErrorの説明は、ありませんでした。そのため、エラー時の動きは、自分の環境で確かめてください。
- 3つのページに、GetLastErrorの記載なし
- エラー時の動きは、自分で確かめる
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のArrayIsSeriesとArrayGetAsSeries、配列が時系列の並びかを確かめる働きと並びの向きの印を読み取る働きどっちを使う?」
時系列の配列かを知るならArrayIsSeries、並びの向きの印を読み取るならArrayGetAsSeriesです。記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










