MENU
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
AIの進化がFXトレーディングに革新を
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
FXAI-FXと人工知能の力
  • ホーム
  • 運営者情報
  • お問い合わせ
  • プライバシーポリシー・特定商取引法に基づく表記
  1. ホーム
  2. FX自動売買と人工知能
  3. MQL5のArrayIsSeriesとArrayGetAsSeries、配列が時系列の並びかを確かめる働きと並びの向きの印を読み取る働きどっちを使う?
⚠️本内容の引用・転載(画像の再アップロード含む)は自由です。その際は当サイトへのリンク設置をお願いします。

MQL5のArrayIsSeriesとArrayGetAsSeries、配列が時系列の並びかを確かめる働きと並びの向きの印を読み取る働きどっちを使う?

2026 11/23
PR
FX自動売買と人工知能
2026年11月23日
MQL5 ArrayIsSeriesとArrayGetAsSeries

この記事を開いてくださったこと、心から感謝しています。インジケーターを作っていると、配列の並びが新しい順なのか古い順なのか、迷う場面があります。そこで役に立つのが、ArrayIsSeriesとArrayGetAsSeriesです。

結論から言うと、ArrayIsSeriesは、その配列が時系列の配列かどうかを調べる関数で、ArrayGetAsSeriesは、配列に付いている並びの向きの印を読み取る関数です。名前は似ていますが、公式の説明では、見ている対象が少し違います。

また、確認した公式ページには、書かれていない点もありました。たとえば、動的配列と静的配列での違い、多次元配列での動き、GetLastErrorの使い方、サンプルの出力例です。その部分は、そのつど「記載なし」と書いています。

この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。

MQL5のArrayIsSeriesとArrayGetAsSeriesの違いをまとめたインフォグラフィック
目次

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つの関数が静的配列でどう動くかは、書かれていません。

名前は似ていても、見ている対象が違うと分かって、整理できました。調べてよかったです。
向きの違いで、新しい値を読み間違えやすいと分かって、納得できました。
Kenichi
Kenichi
記載なしの点が分かると、試すときの確認項目が増えて、落ち着いて進められます。調べておいてよかったです。
まずは向きを表示するところから始められそうで、楽しみになりました。
  • まず、価格の配列の向きを表示する
  • 次に、ArraySetAsSeriesで向きを変えて確かめる
  • 最後に、静的配列を渡したときを確かめる

よくある質問にはどんなものがあるのか?

始める前に、多くの人が気になる疑問を短くまとめます。

2つの関数は、どちらを使えばよいのか?

時系列の配列かを知りたいならArrayIsSeries、AS_SERIESの印を確かめたいならArrayGetAsSeriesです。公式でも、OnCalculateの配列では、後者が案内されています。

  • 時系列かどうかは、ArrayIsSeries
  • 印の有無は、ArrayGetAsSeries

静的配列や多次元配列でも使えるのか?

2つの関数については、確認した公式ページに、書かれていません。ArraySetAsSeriesの注意書きでは、静的配列と多次元配列には印を付けられない、とあります。

  • 2つの関数での動きは、記載なし
  • ArraySetAsSeriesでは、付けられない

エラーが起きたときは、GetLastErrorで調べるのか?

確認した3つのページのどれにも、GetLastErrorの説明は、ありませんでした。そのため、エラー時の動きは、自分の環境で確かめてください。

  • 3つのページに、GetLastErrorの記載なし
  • エラー時の動きは、自分で確かめる

この記事の例は、実際の結果なのか?

いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。

  • 公式サンプルの内容をもとにした説明
  • 実際の動きとは異なる場合がある

まとめ:「MQL5のArrayIsSeriesとArrayGetAsSeries、配列が時系列の並びかを確かめる働きと並びの向きの印を読み取る働きどっちを使う?」

時系列の配列かを知るならArrayIsSeries、並びの向きの印を読み取るならArrayGetAsSeriesです。記載のない点は、自分の環境で確かめてから使いましょう。

  • 時系列かの確認ならArrayIsSeries
  • 向きの印の確認ならArrayGetAsSeries
  • 記載のない点は自分で確かめる

仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。

出典・参照元

  • MQL5 リファレンス(ArrayIsSeries)
  • MQL5 リファレンス(ArrayGetAsSeries)
  • MQL5 リファレンス(ArraySetAsSeries)

※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。

FX自動売買と人工知能
EA FX FXツール FX自動売買 TradingView 取引ツール
よかったらシェアしてね!
  • URLをコピーしました!
  • URLをコピーしました!
  • MQL5のArraySwapとArrayIsDynamic、2つの配列を中身ごと入れ替える働きと入れ替えられる動的配列かを事前に確かめる働きどっちを使う?

この記事を書いた人

Kenichiのアバター Kenichi

もともとは地方の会社員で、投資とはまったく縁のない生活を送っていました。FXを始めたのは、将来のお金への漠然とした不安がきっかけです。

独学でのスタートだったので、最初の数年は失敗の連続でした。根拠のないエントリー、損切りできずに膨らんだ含み損、勝った翌日に全部returnしてしまう——たぶん初心者がやる失敗はひと通り経験したと思います。

そこから、自分に合うやり方を少しずつ探してきました。今も相場を完璧に読めるわけではありませんし、負ける日も普通にあります。ただ、続けてきたなかで見えてきたことや、遠回りして気づいたことはいくつかあります。

専門家というより「少し先を歩いているだけの人」という距離感で、そういった気づきを共有していけたらと思っています。

関連記事

  • MQL5 ArraySwapとArrayIsDynamicの違い
    MQL5のArraySwapとArrayIsDynamic、2つの配列を中身ごと入れ替える働きと入れ替えられる動的配列かを事前に確かめる働きどっちを使う?
    2026年11月22日
  • MQL5 MathIsValidNumberとMathClassifyの違い
    MQL5のMathIsValidNumberとMathClassify、使える数かどうかをはい・いいえで答える手軽さと種類まで細かく分けて返す詳しさどっちを使う?
    2026年11月22日
  • MQL5 MathArctanとMathArctan2の違い
    MQL5のMathArctanとMathArctan2、傾きの値だけから角度を出す手軽さと縦横の2つの値から向きまで決める確かさどっちを使う?
    2026年11月22日
  • MQL5のMathSinとMathCosの違い
    MQL5のMathSinとMathCos、サイン波の上下のゆれを取り出す見通しの良さとコサイン波のずれた位置から始まる扱いやすさどっちを使う?
    2026年11月22日
  • MQL5のiVolumeとiSpreadの違い
    MQL5のiVolumeとiSpread、足ごとの取引の活発さを見るティックボリュームの手軽さと足ごとのスプレッドの広さを見る安心感どっちを使う?
    2026年11月21日
  • MQL5のMathAbsとMathModの違い
    MQL5のMathAbsとMathMod、符号を外して大きさだけを取り出す分かりやすさと割り算の余りを実数で求める便利さどっちを使う?
    2026年11月21日
  • MQL5のMathLogとMathExpの違い
    MQL5のMathLogとMathExp、数を対数で縮めて見る手軽さと指数で元の大きさに戻す見方どっちを押さえる?
    2026年11月21日
  • MQL5 MathRandとMathSrandの比較
    MQL5のMathRandとMathSrand、乱数を取り出す本体の手軽さと出発点を決めて並びをそろえるシードの大切さどっちを押さえる?
    2026年11月21日
検索
人気記事
  • FXの裁量とAI自動売買、口座は分けるべきなの?管理で失敗しないコツ
  • FXのグランビルの法則って何?調べてわかった8つのサインと使い方の注意点
  • セントラル短資FXとLIGHT FX、専門性と高スワップどっちを選ぶ?
  • GMOクリック証券とみんなのFX、取引実績とシンプルな使いやすさどっちを選ぶ?
  • FXのテクニカル分析って何?ファンダメンタルズとの違いを調べてみた
カテゴリ
  • FX自動売買と人工知能
新着記事
  • MQL5 ArrayIsSeriesとArrayGetAsSeries
    MQL5のArrayIsSeriesとArrayGetAsSeries、配列が時系列の並びかを確かめる働きと並びの向きの印を読み取る働きどっちを使う?
  • MQL5 ArraySwapとArrayIsDynamicの違い
    MQL5のArraySwapとArrayIsDynamic、2つの配列を中身ごと入れ替える働きと入れ替えられる動的配列かを事前に確かめる働きどっちを使う?
  • MQL5 MathIsValidNumberとMathClassifyの違い
    MQL5のMathIsValidNumberとMathClassify、使える数かどうかをはい・いいえで答える手軽さと種類まで細かく分けて返す詳しさどっちを使う?
  • MQL5 MathArctanとMathArctan2の違い
    MQL5のMathArctanとMathArctan2、傾きの値だけから角度を出す手軽さと縦横の2つの値から向きまで決める確かさどっちを使う?
  • MQL5のMathSinとMathCosの違い
    MQL5のMathSinとMathCos、サイン波の上下のゆれを取り出す見通しの良さとコサイン波のずれた位置から始まる扱いやすさどっちを使う?
タグ
AI AIツール AI自動売買 ChatGPT自動売買 DMM FX EA EA自動売買 Exness FX FXツール FX初心者 FX取引 FX口座 FX市場 FX業者 FX自動売買 GMOクリック証券 MT4 MT5 SBI FXトレード TradingView VPSサービス スプレッド ダウ理論 チャートパターン テクニカル分析 トレード リスク管理 レバレッジ ロスカット 信頼できるFX業者 初心者 取引 取引ツール 口座開設 国内FX 投資家 比較 海外FX 移動平均線 自動売買 自動売買ツール 資金管理 通貨ペア 通貨強弱

© FXAI-FXと人工知能の力.

目次