この記事を開いてくださったこと、心から感謝しています。配列を同じ値で埋めたいとき、一部だけを埋めるのか、全部を埋めるのか、どちらの関数を選べばよいのか迷っている人も、きっと多いはずです。
結論から言うと、配列の一部の範囲だけを指定した値で埋めたいときはArrayFill、配列の全部をまとめて同じ値にそろえたいときはArrayInitializeです。公式の説明では、ArrayFillは戻り値がなく、ArrayInitializeは初期化した要素の数を返します。
また、確認した公式ページに書かれていない点もありました。たとえば、範囲を超えた位置を指定したときの動きや、エラーコードです。その部分は、そのつど「記載なし」と書いています。
この記事では、MQL5公式リファレンスの説明をもとに、2つの関数の形、戻り値、サンプルの読み方、使い分けを整理します。なお、ここで扱うのはプログラムの仕組みの説明で、運用の助言ではありません。
ArrayFillとArrayInitializeは、そもそも何が違うのか?
まずは、公式リファレンスに書かれている、2つの関数の基本の違いを整理します。どちらも配列を同じ値で埋めますが、埋める範囲と戻り値が違います。
ArrayFillは、開始位置と個数を指定して埋める関数である
ArrayFillは、配列、開始位置、埋める個数、埋める値の4つを渡す関数です。指定した範囲だけが、同じ値になります。戻り値はなく、関数の形はvoidです。
対応する配列の型として、公式には、charやintやdoubleのほか、boolやcolorやdatetimeなど、単純な型が並べられています。文字列や構造体が使えるのかどうかは、書かれていません。
- 配列、開始位置、個数、値を渡す
- 指定した範囲だけが埋まる
- 戻り値は、ない
つまり、ArrayFillは、配列の中の狙った場所だけを、塗りつぶす道具のようなものです。公式の文章に、この例えはありませんが、動きを思い浮かべるときの助けになります。
ArrayInitializeは、配列の全部を同じ値にそろえる関数である
ArrayInitializeは、配列と、そろえる値の2つを渡す関数です。配列のすべての要素が、同じ値になります。戻り値は、初期化した要素の数です。
型ごとの形が用意されていて、公式には、charやshortやintやlongやfloatやdoubleやboolやuintの8種類が載っています。ほかの型は、このページには載っていません。
- 配列と、値の2つを渡す
- 配列の全部が同じ値になる
- 戻り値は、初期化した要素の数
こちらは、配列全体を、まっさらに塗りかえる道具のようなものです。範囲を考える必要がないため、書き間違いが起きにくい点は、使いやすさにつながります。
2つを、表で比べる
公式の説明から読み取れる違いを、表にまとめます。選ぶときの目安として使ってください。
| 項目 | ArrayFill | ArrayInitialize |
|---|---|---|
| 埋める範囲 | 開始位置と個数で指定 | 配列の全部 |
| 戻り値 | なし | 初期化した要素の数 |
| 範囲外の指定 | 記載なし | 該当なし |
| 多次元配列 | 1次元として扱う | 記載なし |
| エラーコード | 記載なし | 記載なし |
※公式の説明をもとにした、筆者の整理です。
ArrayFillは、どんな場面で使うのか?
ArrayFillは、配列の一部の範囲だけを、決めた値で埋めたいときの選択肢です。公式の説明から、動き方を確認します。
公式サンプルは、配列を2つの範囲に分けて埋めている
公式サンプルでは、10個の要素を持つ配列を用意します。そして、0番目から4番目までを123で、5番目から9番目までを456で埋めています。
サンプルのあとには、すべての要素を表示する処理がついています。ただし、公式ページには、表示される結果は載っていません。結果は、自分の環境で確かめる必要があります。配列の大きさを変える関数は、ArrayResizeの記事で整理しています。
- 0番目から4番目を、123で埋める
- 5番目から9番目を、456で埋める
- 表示結果は、公式には載っていない
配列の並び順の設定は、無視される
ArrayFillは、常に左から右への通常の並びで動きます。配列の並び順を逆にする設定をしていても、その設定は無視されると説明されています。開始位置の数え方にも関わるため、注意が必要です。
並び順の設定が、個数の数え方にも影響するのかどうかは、公式には書かれていません。逆順の配列で使うときは、小さな配列で動きを確かめておくと安心です。
- 常に、左から右への並びで動く
- 並び順の設定は、無視される
- 個数への影響は、記載なし
多次元配列は、1次元として扱われる
多次元配列は、1次元の配列として扱われると説明されています。たとえば、2行4列の配列は、8個の要素を持つ配列として処理されます。公式の例では、開始位置5から2個を埋めると、2行目の2列目と3列目が埋まります。
範囲を超える位置を指定したときの動きや、値を型に合わせて変換するときの動きは、公式には書かれていません。小数を整数の配列に入れたときの結果も、記載なしです。
- 多次元配列は、1次元として扱う
- 範囲外の指定は、記載なし
- 値の型の変換は、記載なし
ArrayInitializeは、どんな場面で使うのか?
ArrayInitializeは、配列の全部を、同じ値にそろえたいときの選択肢です。公式の説明から、動き方を確認します。
配列の全部が、指定した値になる
公式の説明では、数値の配列を、あらかじめ決めた値で初期化する関数と説明されています。すべての要素が、新しい値になります。戻り値で、初期化した要素の数を受け取れます。
範囲を指定する引数がないため、一部だけを変えたいときには向きません。その場合は、ArrayFillのほうが合います。
- すべての要素が、同じ値になる
- 戻り値は、初期化した要素の数
- 一部だけを変えるのには、向かない
あとから増やした部分は、初期化されない
公式には、重要な注意が書かれています。配列の大きさを変える関数には、あとで増やすときのために、余分な領域を確保する使い方があります。ArrayInitializeを使っても、この確保した領域は、初期化されません。
あとで配列を大きくすると、新しく加わる要素の値は決まっていません。公式では、多くの場合、初期化した値とは一致しないと説明されています。大きさを変えたあとは、もう一度、初期化や埋める処理が必要です。
- 確保した余分な領域は、初期化されない
- 増えた要素の値は、決まっていない
- 大きさを変えたあとは、改めて埋める
対応する型や、多次元配列の動きは、確認できない
公式に載っている型の形は、8種類です。それ以外の型、たとえば符号なしの小さい整数や日時の型で使えるのかどうかは、このページからは分かりません。多次元配列の動きも、記載なしです。
空の配列に使ったときの戻り値や、エラーのときの動きも、書かれていません。使う前に、自分の環境で試してから、組み込むのが安心です。
- 8種類以外の型は、記載なし
- 多次元配列は、記載なし
- 空の配列の戻り値は、記載なし
どう使い分ければよいのか?
一部の範囲を埋めたいならArrayFill、全部をそろえたいならArrayInitializeです。ただし、配列の大きさを変えたあとの扱いには、どちらでも注意が必要です。
一部の範囲だけを埋めたいなら、ArrayFillを選ぶ
開始位置と個数を指定して、範囲を絞って埋めたいなら、ArrayFillが向いています。戻り値がないため、結果は、配列を見て確かめることになります。
FX口座・ツールの比較一覧もあわせて確認してみてください。
全部をそろえたいなら、ArrayInitializeを選ぶ
配列の全部を、同じ値でそろえたいなら、ArrayInitializeが向いています。引数が少なく、書き方も短くなります。初期化した要素の数を、戻り値で確かめられる点も便利です。
- 全部を同じ値にそろえる
- 引数が、少ない
- 戻り値で、数を確かめられる
たとえば、配列を作った直後に、すべての要素を決まった値にそろえておきたい場面では、ArrayInitializeが考えやすい選択です。ただし、公式には、この使い方の例は載っていません。
大きさを変えるときは、埋め直しを考える
配列を大きくしたあとの要素は、決まった値ではありません。どちらの関数を使う場合でも、大きさを変えたあとに、必要な範囲を、改めて埋めておくと安心です。並べ替えなどの関連する関数は、ArraySortとArrayBsearchの記事で扱っています。
- 大きさを変えたあとは、値が決まっていない
- 必要な範囲を、改めて埋める
- 結果は、表示して確かめる
実際に使うとき、どんな順番で進めればよいのか?
最後に、確認の順番を整理します。まずは、スクリプトで、小さな配列を使って確かめるのが安心です。
まずは、小さな配列で結果を表示する
最初は、10個程度の配列を用意して、ArrayFillで範囲を分けて埋めます。そのあと、すべての要素を表示して、どの位置が、どの値になったのかを確かめます。公式に結果が載っていないため、自分の環境の結果が、そのまま判断材料になります。
- 10個程度の配列を用意する
- 範囲を分けて埋める
- すべての要素を表示する
表示した結果は、使った環境や設定で変わる可能性があります。入力した値と、表示された結果を、セットでメモに残しておくと、あとで見返すときに役立ちます。
次に、ArrayInitializeの戻り値を確かめる
次に、同じ配列にArrayInitializeを使って、戻り値を表示します。初期化した要素の数が、配列の大きさと同じになるかどうかを、自分の目で確かめます。
- 同じ配列で、全部をそろえる
- 戻り値を、表示する
- 配列の大きさと比べる
最後に、大きさを変えたあとの要素を確かめる
最後に、配列の大きさを変えて、増えた要素の値を表示します。公式の説明のとおり、値が決まっていないことを、自分の環境で確かめておくと、あとで困りにくくなります。









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










