この記事を開いてくださったこと、心から感謝しています。大きな配列を扱うとき、中身をコピーせずに、まるごと入れ替えたい場面があります。そこで登場するのが、ArraySwapです。
結論から言うと、ArraySwapは、同じ型の動的配列2つの中身を入れ替える関数で、ArrayIsDynamicは、ある配列が動的配列かどうかを調べる関数です。役割が違うため、競合するというより、組み合わせて考える関数です。
また、確認した公式ページに書かれていない点もありました。たとえば、入れ替えたあとの元の配列の中身、文字列や構造体を渡せるのか、サンプルの出力例です。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、引数、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ArraySwapとArrayIsDynamicは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本を整理します。ArraySwapは配列の中身を動かす関数、ArrayIsDynamicは配列の種類を調べる関数です。
ArraySwapは、2つの動的配列の中身を入れ替える関数である
ArraySwapの形は、bool ArraySwap(void& array1[], void& array2[]) です。引数は2つの配列で、どちらも入力と出力を兼ねており、公式では「数値型の配列」と説明されています。
公式には、同じ型の動的配列2つの中身を入れ替える、と書かれています。多次元配列の場合は、最初の次元を除いた、ほかの次元の要素数をそろえる必要がある、という説明もあります。
戻り値は、成功なら真、失敗なら偽です。偽のときは、GetLastErrorがERR_INVALID_ARRAYを返す、と書かれています。成功したときのGetLastErrorについては、説明がありません。
- 引数は、同じ型の動的配列を2つ
- 戻り値は、成功なら真、失敗なら偽
- 失敗のとき、GetLastErrorはERR_INVALID_ARRAY
- 整数型では、符号の違いは無視される
ArrayIsDynamicは、動的配列かどうかを調べる関数である
ArrayIsDynamicの形は、bool ArrayIsDynamic(const void& array[]) です。引数は調べたい配列で、公式では「Checked array」と説明されています。
公式には、配列が動的配列かどうかを調べる関数、と書かれています。戻り値は、動的配列なら真、そうでなければ偽です。注意書きの欄は、ありません。
- 引数は、調べたい配列を1つ
- 戻り値は、動的配列なら真
- 注意書きの欄は、なし
- 対応する配列の種類は、記載なし
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ArraySwap | ArrayIsDynamic |
|---|---|---|
| 役割 | 2つの配列の中身を入れ替える | 動的配列かどうかを調べる |
| 引数 | 配列を2つ(入出力) | 配列を1つ(入力) |
| 戻り値 | 成功なら真 | 動的配列なら真 |
| GetLastError | 失敗時にERR_INVALID_ARRAY | 記載なし |
| 対象 | 同じ型の動的配列 | 調べたい配列 |
| 注意書き | あり | なし |
※公式の説明をもとにした、筆者の整理です。
ArraySwapを使うとき、何に気をつければよいのか?
ArraySwapは、使える条件が決まっています。公式の説明をもとに、条件と、書かれていない点を整理します。
入れ替えられるのは、同じ型の動的配列である
公式には、同じ型の動的配列、という条件が書かれています。サイズが決まっている静的配列は、対象に含まれていないと読み取れますが、静的配列を渡したときの動きは、記載がありません。
ここで役に立つのが、ArrayIsDynamicです。先に動的配列かどうかを調べておけば、入れ替えに失敗する原因の1つを、減らせます。これは、公式の説明そのものではなく、筆者の整理です。
- 同じ型の動的配列が、条件
- 静的配列を渡したときの動き:記載なし
- 先にArrayIsDynamicで確かめる、という使い方が考えられる
多次元配列は、最初の次元以外をそろえる
多次元配列を入れ替えるときは、最初の次元以外の要素数が、同じである必要があります。たとえば、2次元で、列の数が同じなら、行の数は違っていても構いません。
この説明は、公式のページにある条件の読み取りです。行や列の数が違う場合に、どんな失敗になるかの詳しい説明は、ページには書かれていません。
- 最初の次元は、違ってもよい
- それ以外の次元は、そろえる
- 違った場合の細かい動き:記載なし
書かれていない点は、自分で確かめる
このほか、確認した公式ページには、書かれていない点がいくつかありました。使う前に、自分の環境で確かめておくと安心です。
- 入れ替え後、元の配列の中身がどうなるか:記載なし
- 入れ替え後の大きさの扱い:記載なし
- 文字列や構造体の配列を渡せるか:記載なし
- サイズの違う整数型どうしの扱い:記載なし
- サンプルの出力例:記載なし
サンプルのコメントには、入れ替えの後、元の配列が空になることを確かめる、という趣旨の記述があります。ただし、コードでは、大きさを表示しているだけです。決まりとして書かれているわけではありません。
公式サンプルは、どう読めばよいのか?
2つの関数のサンプルは、作りがだいぶ違います。ArraySwapは、価格データを使ったスクリプト、ArrayIsDynamicは、インジケーターの形です。
ArraySwapのサンプルは、価格データを入れ替えている
ArraySwapのサンプルでは、まず、CopyRatesで直近20本の価格データを取得します。失敗したときは、エラーを表示して、処理を終えます。
次に、取得した本数に合わせて、元の配列の大きさを決め、1本ごとに、時間、始値、高値、安値、終値、ティックの出来高、スプレッド、実際の出来高を、8つの列に入れます。
そして、ArraySwapで、元の配列と、行き先の配列を入れ替えます。失敗したときは、エラーコードを表示して終わります。成功したときは、元の配列の大きさと、行き先の配列の中身を表示します。
- CopyRatesで、直近20本を取得する
- 8つの列に、数値として入れる
- ArraySwapで入れ替える
- 行き先の配列の中身を表示する
CopyRatesの仕組みは、CopyRatesとiCloseの記事で整理しています。サンプルの前半の流れを、確かめたいときに、あわせて読むと分かりやすくなります。
ArrayIsDynamicのサンプルは、3種類の配列を比べている
ArrayIsDynamicのサンプルは、計算をしないインジケーターです。動的配列、静的配列、インジケーターバッファの3つに、ArrayFreeを1回だけ使い、結果をログに表示します。
| 配列 | 種類 | サンプルの中身 |
|---|---|---|
| ExtDynamic | 動的配列 | OnInitで100要素にする |
| ExtStatic | 静的配列 | 最初から100要素 |
| ExtBuff | インジケーターバッファ | SetIndexBufferで割り当てる |
※公式サンプルのコードをもとにした、筆者の整理です。
3つのそれぞれについて、大きさ、動的配列かどうか、ArrayFreeを使ったあとの大きさを表示する作りです。表示は最初の1回だけで、あとは何もしません。出力例は、ページには書かれていません。
サンプルを読むときの注意点がある
ArraySwapのサンプルのコメントや表示の文言には、実際の変数名と違うものが混ざっています。たとえば、存在しない配列の名前が、コメントに出てきます。
- コメントの配列名が、実際の変数名と違う
- 失敗時の表示の変数名も、違う
- 元の配列が空になることは、コードでは確かめていない
このように、公式サンプルは、呼び方を示すのが主な目的で、細かい表記までは整っていません。実際に使うときは、自分で結果を表示して、確かめてください。
どう使い分ければよいのか?
配列の中身を入れ替えたいならArraySwap、動的配列かどうかを確かめたいならArrayIsDynamicです。両方を並べて使う場面もあります。
中身を入れ替えたいなら、ArraySwapを選ぶ
同じ型の動的配列が2つあり、中身をそっくり入れ替えたいなら、ArraySwapです。公式のサンプルでも、価格データを入れた配列を、別の配列へ移す形で使われています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
動的配列かどうかを確かめたいなら、ArrayIsDynamicを選ぶ
受け取った配列が、動的配列なのかが分からないときは、ArrayIsDynamicで確かめます。戻り値が真か偽だけなので、条件分岐に、そのまま使えます。
- 動的配列かどうかを、真偽で返す
- 条件分岐に、そのまま使える
- 対応する配列の種類は、記載なし
2つを組み合わせて使う方法もある
入れ替えの前に、ArrayIsDynamicで、両方の配列が動的配列かどうかを確かめ、真のときだけArraySwapを呼ぶ、という流れが考えられます。
これは、公式の説明そのものではなく、筆者が整理した使い方です。配列の大きさを決める関数は、ArrayResizeの記事で整理しています。あわせて参照してください。
- まず、ArrayIsDynamicで確かめる
- 真のときだけ、ArraySwapで入れ替える
- 動きは、自分の環境で確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、小さな配列を使って、スクリプトで確かめるのが安心です。
まずは、小さな動的配列で確かめる
最初は、数個の要素だけを持つ、小さな動的配列を2つ用意して、ArraySwapを呼びます。戻り値と、入れ替えの前後の配列の大きさを、表示して確かめます。
- 同じ型の動的配列を2つ用意する
- ArraySwapを呼ぶ
- 前後の大きさと中身を表示する
次に、静的配列を渡したときを確かめる
次に、静的配列を片方に渡してみます。このときの動きは、公式には書かれていないため、戻り値と、GetLastErrorの値を、自分の環境で確かめます。
- 静的配列を1つ混ぜる
- 戻り値を確かめる
- GetLastErrorの値を確かめる
最後に、ArrayIsDynamicで事前に判定する
最後に、ArrayIsDynamicを組み合わせて、動的配列のときだけ、入れ替えるようにします。条件の分岐が正しく動くかを、2つの場合で見比べます。









- まず、小さな動的配列で確かめる
- 次に、静的配列を渡したときを確かめる
- 最後に、ArrayIsDynamicで事前に判定する
よくある質問にはどんなものがあるのか?
始める前に、多くの人が気になる疑問を短くまとめます。
静的配列も、入れ替えられるのか?
公式には、動的配列の入れ替え、と書かれています。静的配列を渡したときの動きは、記載がありません。自分の環境で試して、確かめてください。
- 公式の対象は、動的配列
- 静的配列の動きは、記載なし
入れ替えたあと、元の配列はどうなるのか?
確認した公式ページには、決まりとして書かれていません。サンプルのコメントから、空になることを期待していると読めますが、はっきりした説明ではありません。
- 決まりとしては、記載なし
- サンプルのコメントから、期待は読み取れる
文字列や構造体の配列も、入れ替えられるのか?
引数の説明は、数値型の配列となっていますが、同じ型、という書き方もあります。文字列や構造体を渡せるかどうかは、記載がありません。
- 引数の説明は、数値型の配列
- 文字列や構造体は、記載なし
この記事の例は、実際の結果なのか?
いいえ、公式サンプルの内容と、筆者が整理した説明です。実際の動きや、将来の結果を示すものではありません。
- 公式サンプルの内容をもとにした説明
- 実際の動きとは異なる場合がある
まとめ:「MQL5のArraySwapとArrayIsDynamic、2つの配列を中身ごと入れ替える働きと入れ替えられる動的配列かを事前に確かめる働きどっちを使う?」
中身を入れ替えるならArraySwap、動的配列かどうかを確かめるならArrayIsDynamicです。記載のない点は、自分の環境で確かめてから使いましょう。
仕組みが分かると、コードを書くのが少しずつ楽しくなっていきます。この記事が、あなたの毎日に少しでも余裕と安心を運ぶきっかけになれば、心から嬉しく思います。
出典・参照元
※本ページに掲載している口コミ・体験談は、特定の個人を特定できないよう配慮しており、ウェブサイトおよびSNS上の公開情報をもとに編集しています。個人の体験に基づく情報であり、すべての方に同じ効果や変化が生じることを保証するものではありません。料金・サービス内容は変更される場合があるため、最新情報は必ず公式サイトでご確認ください。










