この記事を開いてくださったこと、心から感謝しています。配列の大きさを変えたいのか、中身を別の配列へ写したいのか、迷っている人も、きっと多いはずです。
結論から言うと、配列の要素の数を増やしたり減らしたりしたいときはArrayResize、ある配列の中身を別の配列へ写したいときはArrayCopyです。仕事が違う関数なので、片方がもう片方の代わりになるわけではありません。
また、確認した公式ページに書かれていない点もありました。たとえば、失敗したときのエラーコードや、テスターでの動きです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ArrayResizeとArrayCopyは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも配列を扱いますが、やることが違います。
ArrayResizeは、第1次元の大きさを変える関数である
ArrayResizeは、配列と新しい大きさを渡すと、配列の第1次元の要素数を変える関数です。3つ目の引数で、あらかじめ余分な領域を確保しておくこともできます。
戻り値は整数です。成功したときは、変更後の配列の全要素数が返り、失敗したときは-1が返って、配列の大きさは変わりません。
- 配列と、新しい大きさを渡す
- 3つ目に、余分な領域の大きさを渡せる
- 失敗すると、-1が返る
ArrayCopyは、配列の中身を別の配列へ写す関数である
ArrayCopyは、写し先の配列、写し元の配列、それぞれの開始位置、要素数を渡すと、中身を写す関数です。開始位置と要素数は、省略できます。
戻り値は、写した要素の数です。公式のページには、失敗したときに何が返るのかは、書かれていません。
- 写し先と写し元の配列を渡す
- 開始位置と要素数は、省略できる
- 戻り値は、写した要素の数
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ArrayResize | ArrayCopy |
|---|---|---|
| 主な役目 | 要素数を変える | 中身を写す |
| 渡すもの | 配列、新しい大きさ、余分な領域 | 写し先、写し元、位置、要素数 |
| 戻り値 | 変更後の全要素数、失敗は-1 | 写した要素の数 |
| 失敗したときの戻り値 | -1と書かれている | 記載なし |
| エラーコード | 記載なし | 記載なし |
| テスターでの動き | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ArrayResizeは、どんな場面で使うのか?
ArrayResizeは、データの数が増えたり減ったりする配列で、大きさを合わせたいときに使います。公式の説明から、動き方を確認します。
使えるのは、動的配列だけである
公式には、ArrayResizeは動的配列にだけ使える、と書かれています。大きさが決まっている配列や、時系列の配列、指標のバッファは、領域を取り直しません。
その場合、新しい大きさが今の大きさ以下なら、新しい大きさがそのまま返り、それより大きいなら-1が返る、と説明されています。つまり、大きくはできません。
- 動的配列が、本来の対象
- 固定の大きさの配列は、領域を取り直さない
- 今より大きくしようとすると、-1が返る
指標のバッファは、自分では大きさを変えられない
公式には、SetIndexBufferで指標のバッファにした動的配列は、プログラム側から大きさを変えられない、とも書かれています。大きさの変更は、ターミナルが行います。
そのため、指標を作るときは、バッファに対してArrayResizeを呼ぶ前に、一度立ち止まって確かめるのが安心です。
- バッファの大きさは、ターミナルが変える
- 自分で変えようとしない
- 別の作業用の配列を用意する方法もある
余分な領域を確保すると、領域の取り直しが減る
3つ目の引数は、余分な領域の大きさです。公式には、何度も大きさを変える場面では、この引数を使うと、実際に領域を取り直す回数が減る、と説明されています。
公式の説明では、1000要素に1000の余分を確保し、1から2999まで大きさを変える例が出ています。この場合、領域を取り直すのは2回だけで、余分がなければ約2000回、と書かれています。
- 余分な領域は、領域を取るときだけ使われる
- 大きさを変える回数が多いときに向く
- 余分を指定しない場合は、取り直しが増える
公式サンプルでは、速さの差が表示されている
公式サンプルは、余分な領域を使う場合と、使わない場合で、30万回まで大きさを変えて、かかった時間を表示します。画面の出力例では、前者は0ミリ秒、後者は最後に228511ミリ秒と書かれています。
ただし、サンプルの「使わない」側も、最初の呼び出しでは余分を確保しています。その影響について、公式の文章に説明はありません。数字は、あくまで公式の出力例として読みましょう。
- 出力例は、公式のコメントに載っている
- 使わない側にも、最初の余分がある
- 数字の差の理由は、記載なし
要素の中身や上限は、確認できない点が多い
全要素数の上限は2147483647と書かれています。一方で、大きくしたときに、元の中身が残るのか、増えた要素が何で埋まるのかは、このページに書かれていません。
多次元の配列の細かい扱いや、エラーコード、テスターでの動きも、記載なしです。大きくしたあとの要素は、自分で値を入れてから使うと安心です。
- 上限は、2147483647
- 元の中身が残るかは、記載なし
- 増えた要素の値は、記載なし
ArrayCopyは、どんな場面で使うのか?
ArrayCopyは、ある配列の一部、または全部を、別の配列へ写したいときに使います。公式の説明から、動き方を確認します。
要素数の指定が大きすぎても、残り全部が写される
公式には、要素数が負の値のとき、または、写し元の残りより多いときは、開始位置から残り全部が写される、と書かれています。指定をまちがえても、範囲の外には出ません。
省略したときの既定値は、配列全体を表す値です。数値そのものは、このページには書かれていません。
- 負の値なら、残り全部が写される
- 多すぎても、残り全部が写される
- 既定値は、配列全体を表す
型がちがう配列にも写せるが、条件がある
公式には、型のちがう配列へ写すとき、写し元の各要素は、写し先の型に変換される、と書かれています。ただし、変換の細かい規則は、書かれていません。
文字列の配列は、文字列の配列にしか写せません。構造体の配列も、同じ構造体の配列にしか写せません。初期化が必要なオブジェクトを含む配列は、写せないと説明されています。
- 型のちがいは、写すときに変換される
- 文字列は、文字列の配列へだけ
- 構造体は、同じ構造体の配列へだけ
時系列の配列では、写し先が自動で大きくなる
公式には、時系列として添字を数える動的配列では、写す量が写し先に収まらないとき、写し先が自動で大きくなる、と書かれています。ただし、自動で小さくなることはありません。
コピーは、左から右へ進みます。時系列の配列では、その向きになるよう、開始位置が調整されると説明されています。
- 自動で大きくなる場合がある
- 自動で小さくはならない
- 左から右の向きで写される
公式サンプルは、指標のバッファへ写している
公式サンプルは、局所の極値を表示する指標です。極値の区間で、始値、高値、安値、終値の4つのバッファへ、ArrayCopyで中身を写しています。位置と要素数は、4回とも同じです。
このサンプルには、画面に出る文字の出力はなく、結果はチャートに描かれます。写し先と写し元で同じ開始位置を使っているため、位置のずれがある場合の動きは、確認できません。
- 4つのバッファへ、4回写す
- 開始位置は、写し先と写し元で同じ
- 結果は、チャートに描かれる
同じ配列の中で写す場合などは、記載がない
ある配列から、自分自身へ写す場合や、範囲が重なる場合の動きは、公式のページに書かれていません。写し先が小さすぎる場合の失敗の動きも、記載なしです。
写す範囲の外にある、写し先の元の中身がどうなるのかも、書かれていません。大事な値が入った配列へ写すときは、事前に別の場所へ控えておくと安心です。
- 自分自身への写しは、記載なし
- 範囲が重なる場合は、記載なし
- 範囲の外の中身は、記載なし
どう使い分ければよいのか?
要素数を変えたいならArrayResize、中身を写したいならArrayCopyです。やりたいことが、どちらなのかで決まります。
データの数が変わる配列なら、ArrayResizeを選ぶ
集めるデータの数が、実行中に増えたり減ったりする配列は、ArrayResizeで大きさを合わせます。何度も変える場合は、余分な領域の指定も、候補に入ります。
配列そのものの扱いを広く知りたいときは、iHighestとArrayMaximumの記事で、配列の最大値を探す関数も整理しています。
FX口座・ツールの比較一覧もあわせて確認してみてください。
中身を写したいなら、ArrayCopyを選ぶ
配列の一部を取り出したいときや、別の配列へ値を移したいときは、ArrayCopyが向いています。型の変換も、写すときに一緒に行われます。
- 一部だけ写したい
- 別の配列へ値を移したい
- 型の変換が必要になる場合がある
組み合わせて使うこともできる
写し先が動的配列なら、先にArrayResizeで大きさを用意してから、ArrayCopyで写す、という順番が考えられます。時系列の配列は、写し先が自動で大きくなる場合もあります。
- 先に、ArrayResizeで大きさを用意する
- 次に、ArrayCopyで写す
- 結果の要素数を、戻り値で確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、小さな配列を作って確かめるのが安心です。
まずは、ArrayResizeの戻り値を表示する
最初は、動的配列の大きさを変えて、戻り値をログに出します。成功のときの値と、-1が返る場合の違いを、自分の目で確かめます。
- 小さな動的配列を用意する
- 戻り値を、ログに出す
- 大きさを、ArraySizeで確かめる
次に、ArrayCopyで一部だけ写してみる
次に、数個の要素を持つ配列から、一部だけを別の配列へ写します。要素数を多めに指定して、残り全部が写されることも、試します。
- 開始位置を変えて試す
- 要素数を、多めに指定して試す
- 戻り値の要素数を、確かめる
最後に、2つを組み合わせて試す
最後に、ArrayResizeで写し先を用意してから、ArrayCopyで写してみます。結果が思ったとおりかを、ログで確かめます。









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










