MENU

Excel VBA 配列とは?基礎的使い方をサンプルで詳しく解説

Excel VBA 配列とは?基礎的使い方をサンプルで詳しく解説

同じ種類のデータを番号付きで格納できるのが「配列」です。配列を覚えると同じような内容の変数をまとめてしまうことでVBAコードをスリム化できます。配列データを一括してシートのセルへ書き込む等VBAの実行速度向上にも役立ちます。

くるみこ

今まで、すでに「配列」を使っていますが「配列」とはどのようなものかについては詳しく解説していませんでした。ということで、今回は 配列について勉強しましょう!

すみませ~ん! 予習しようとしたけど難しいです! よくわからないので是非詳しく教えてください。よろしくお願いしますm(_ _)m

前回のおさらいはこちらの記事です(^^)/ 下のカードをクリックすれば開きます。

くるみこ

前回記事でわかったことは
・Timer関数の使い方・利用方法
・VBAテスト実行などでウエイトをかける方法
・文字列日付を日付型に変換する方法
・検索時など日付型の違いによる注意点

【この記事でわかることは】

  • 「配列」とは何か
  • 「配列」の宣言方法、代入方法や配列データの使用方法の基礎
  • 要素数の調べ方(UBound関数、LBound関数)
  • 二次元配列の使い方
  • 静的配列と動的配列の違い、ReDim と Preserve の使い方
  • エラーになるときの確認ポイント

この記事のサンプルはこのリンク先からダウンロードできます!

目次

配列とは

配列とは、同じデータ型のデータを配列として1つにまとめた変数のことです。配列内のデータは、何番目のデータかを特定できるように番号付きで格納されます。この番号のことを「インデックス番号」と言います。また、配列を構成する1つ1つの変数は一般的に「要素」と呼ばれています。

たとえば5個の数値を扱うとき、普通の変数なら5個宣言する必要があります。配列なら宣言は1つで済みます。

'普通の変数で5個の値を扱う場合
Dim a1 As Long, a2 As Long, a3 As Long, a4 As Long, a5 As Long

'配列で5個の値を扱う場合
Dim a(4) As Long

番号で要素を指定できるので、For Next でまとめて処理できるのが配列の大きな利点です。

配列aの中に5個の要素が並び、それぞれにインデックス番号0から4が付いている図

配列の宣言方法は

  • 配列を使用するときは、宣言が必要です
  • 配列の型宣言は変数と同じです。As を省略すると、Variant(バリアント)型になります
  • 宣言の方法は変数と同じですが、配列の場合は配列名の後に「()」(カッコ)を記述し、その中に配列の範囲を記述します。宣言した時点で指定された領域分のメモリが確保されます

宣言例:Dim 配列名(インデックス番号の最大値) As データ型

配列のインデックス番号は「0」から始まりますので、要素数はインデックス番号の最大値に1を足した数になります。To を使うと、開始の番号も指定できます。

宣言インデックス番号の範囲要素数
Dim a(4) As Long0~45
Dim a(1 To 5) As Long1~55
Dim aa(100) As String0~100101
Dim aa(5 To 100) As String5~10096

モジュールの先頭に Option Base 1 と宣言すると、開始の番号を省略した配列は「1」から始まります。Option Base に指定できるのは0か1だけです。

配列の要素に代入する方法

配列の要素に値を代入するには次のように記述します。

 「配列名(インデックス番号) = 代入する数値・文字列など」

次のコードは、要素数5の配列aの要素にそれぞれ5づつ増える値を代入しセルに書き込みます。

'配列の宣言とForLoopを使った値代入例
Sub Sample01()
    Dim i As Long
    Dim a(4) As Long    '配列の宣言
    For i = 0 To 4
        a(i) = i * 5 + 5
    Next
    '代入したデータをセルに書き込む
    For i = 0 To 4
        Cells(i + 1, 1) = a(i)
    Next
End Sub

次は、列名(インデックス番号の最小値 To インデックス番号の最大値) As データ型 の例です。

'数値指定配列の宣言とForLoopを使った値代入例
Sub Sample02()
    Dim i As Long
    Dim a(1 To 5) As Long    '配列の宣言
    For i = 1 To 5
        a(i) = i * 5
    Next
    '代入したデータをセルに書き込む
    For i = 1 To 5
        Cells(i, 1) = a(i)
    Next
End Sub

どちらも結果は同じ(5,10,15,20,25)になります。

ループの開始番号を「0」に変更して実行すると、ない番号を指定することになるので「実行時エラー ‘9’: インデックスが有効範囲にありません。」が表示されます。

要素数を調べる方法(UBound関数、LBound関数)

インデックス番号の最大値は UBound関数、最小値は LBound関数で取得できます。For Next の範囲にこの2つを使えば、宣言を変えてもループを書き直す必要がありません。

'UBoundとLBoundで配列全体を処理する例
Sub Sample07()
    Dim i As Long
    Dim a(1 To 5) As Long    '配列の宣言
    For i = LBound(a) To UBound(a)
        a(i) = i * 5
    Next
    MsgBox "要素数は " & UBound(a) - LBound(a) + 1 & " です"
End Sub

要素数は「UBound - LBound + 1」で求められます。このサンプルでは「要素数は 5 です」と表示されます。関数の詳しい使い方は、Excel VBA 配列の処理に役立つ3つの関数を紹介しますをご覧ください。

多次元配列とは

これまで解説した配列は、インデックスが1つの「一次元配列」です。配列には、インデックスを複数持つ「多次元配列」もあります。インデックスが2つなら二次元配列、3つなら三次元配列で、最大次元数は60までと制限があります。

二次元配列は、ワークシートのように縦横に並んでいる状態をイメージすればよいでしょう。

多次元配列の宣言方法

多次元配列の宣言方法は、「()」内に「縦のインデックス番号の最大値,横のインデックス番号の最大値」を記述します。ワークシートで言えば、「行の最大値,列の最大値」ということになります。

宣言例:Dim 配列名(縦最大インデックス番号,横最大値インデックス番号) As データ型

二次元配列aa(1, 3)の8個の要素が縦2行、横4列に並び、それぞれの要素に1から8の値が入っている図

こちらは、縦2×横4の二次元配列の事例です(セルに結果を書き込むところまで)。

'2次元配列の宣言と値代入例
Sub sample03()
    Dim aa(1, 3) As Long    '縦2行、横4列の配列を宣言
    aa(0, 0) = 1
    aa(0, 1) = 2
    aa(0, 2) = 3
    aa(0, 3) = 4
    aa(1, 0) = 5
    aa(1, 1) = 6
    aa(1, 2) = 7
    aa(1, 3) = 8
    '代入したデータをセルに書き込む
    Cells(1, 1) = aa(0, 0)
    Cells(1, 2) = aa(0, 1)
    Cells(1, 3) = aa(0, 2)
    Cells(1, 4) = aa(0, 3)
    Cells(2, 1) = aa(1, 0)
    Cells(2, 2) = aa(1, 1)
    Cells(2, 3) = aa(1, 2)
    Cells(2, 4) = aa(1, 3)
End Sub

同じものを2次元のFor Loopで処理する場合の例です(セルに結果を書き込むところまで)。

'2次元配列の宣言と2次元のForLoopを使った値代入例
Sub sample04()
    Dim aa(1, 3) As Long    '縦2行、横4列の配列を宣言
    Dim i As Long, j As Long, n As Long
    For i = 0 To 1
        For j = 0 To 3
            n = n + 1
            aa(i, j) = n
        Next j
    Next i
    '代入したデータをセルに書き込む
    For i = 0 To 1
        For j = 0 To 3
            Cells(i + 1, j + 1) = aa(i, j)
        Next j
    Next i
End Sub

配列が大きくなるほど、Loop処理を使えばコードをコンパクトにできますね。配列の番号は0から、セルの行と列は1から始まるので、Cells(i + 1, j + 1) のように1を足している点も確認してください。

ここまで紹介した配列は、要素数が決まっている場合の宣言と代入・書き込み方法です。このように、あらかじめ要素数が決まっている配列のことを「静的配列」と呼びます。

複雑なプログラムになると、要素数が定まっていないケースが沢山出てきます。そのような場合には、「動的配列」を使うことになります。

動的配列とは

「動的配列」とは、宣言時に要素数を決めず、実行時に要素数を変更できる配列のことです。配列に格納する要素数が分からない場合は、「動的配列」を利用します。

静的配列動的配列
宣言Dim a(4) As LongDim a() As Long
要素数を決めるとき宣言するときReDim を実行するとき
要素数の変更できない何度でもできる

動的配列の宣言方法

「動的配列」を利用する場合は、宣言時に要素数を設定しません。

宣言例:Dim 配列名() As データ型   ←()内には何も入れません

実行時に、「動的配列」の次元数や要素数を変更する ReDim ステートメントを利用して、() 内にインデックス番号の最大値を割り当てます。

宣言例:ReDim 配列名(インデックス番号の最大値)

「動的配列」の事例です。ReDim で配列a()に(2)を割り当てています。

'動的配列とRedimステートメントサンプル
Sub Sample05()
    Dim a() As Long
  
    ReDim a(2)
    a(0) = 5
    a(1) = 10
    a(2) = 15
    '代入したデータをセルに書き込む
    Cells(1, 1) = a(0)
    Cells(2, 1) = a(1)
    Cells(3, 1) = a(2)
End Sub

ReDim には変数も指定できます。この点が動的配列の便利なところです。次のサンプルは、A列のデータ数に合わせて配列を用意し、2倍にした値をB列に書き込みます。

'A列のデータ数に合わせて動的配列を用意する例
Sub Sample08()
    Dim i As Long
    Dim LastRow As Long
    Dim a() As Long
  
    LastRow = Cells(Rows.Count, 1).End(xlUp).Row    'A列の最終行
    ReDim a(1 To LastRow)
    For i = 1 To LastRow
        a(i) = Cells(i, 1) * 2
    Next
    '代入したデータをセルに書き込む
    For i = 1 To LastRow
        Cells(i, 2) = a(i)
    Next
End Sub

Sample01 を実行した後でこのサンプルを実行すると、B列に10,20,30,40,50と書き込まれます。A列のデータが増えても、コードを変更する必要はありません。

ReDim ステートメントとは

プロシージャレベルで使用され、動的配列変数の記憶領域を再割り当てします。

構文
ReDim [Preserve] varname(subscripts)[As type]

・Preserve は省略可能です。既存データを保持したまま要素数を変更します
・varname は必須です。要素数を変更する動的配列変数名を指定します
・subscripts は必須です。変更する要素数を指定します
・type は省略可能です。配列変数のデータ型を指定します

ReDim には次の特徴があります。

  • ReDim ステートメントを繰り返し使用して、配列内の次元数や要素数を変更できます
  • 一度設定したデータ型を変更することはできません
  • すでに値が格納されていた場合は、再設定の時点ですべての値が破棄されます

値が破棄されるのは、配列変数の格納領域がまったく新しく割り当てられるためです。配列の値を保持した状態で要素数を変更したい場合は、Preserve キーワードを利用します。

Preserveキーワード

Preserve キーワードを使用した場合、配列に含まれる既存のデータを消去することなく、動的配列の最後の次元のサイズを変更することができます。

宣言例:ReDim Preserve 配列名(インデックス番号の最大値)

こちらは、要素数の変更と配列の値の状態をチェックするサンプルコードです。

'ReDim Preserveの動作検証サンプル
Sub Sample06()
    Dim a() As Long
  
    ReDim a(1, 1)
    a(0, 0) = 1
    a(0, 1) = 2
    a(1, 0) = 10
    a(1, 1) = 20
    
    ReDim Preserve a(1, 2)  '横に1追加
    a(0, 2) = 3
    a(1, 2) = 30
    MsgBox "配列a(0, 0)の値:" & a(0, 0) & vbCrLf & _
           "配列a(0, 1)の値:" & a(0, 1) & vbCrLf & _
           "配列a(0, 2)の値:" & a(0, 2) & vbCrLf & _
           "配列a(1, 0)の値:" & a(1, 0) & vbCrLf & _
           "配列a(1, 1)の値:" & a(1, 1) & vbCrLf & _
           "配列a(1, 2)の値:" & a(1, 2)
             
    ReDim a(2, 3)           'ReDimで再び要素数をセット
    MsgBox "配列a(0, 0)の値:" & a(0, 0) & vbCrLf & _
           "配列a(0, 1)の値:" & a(0, 1) & vbCrLf & _
           "配列a(0, 2)の値:" & a(0, 2) & vbCrLf & _
           "配列a(1, 0)の値:" & a(1, 0) & vbCrLf & _
           "配列a(1, 1)の値:" & a(1, 1) & vbCrLf & _
           "配列a(1, 2)の値:" & a(1, 2)
End Sub
  • 11行目で、Preserveキーワードを使用して配列の要素を追加しています
  • 14行目で、追加後のデータを表示しています。元の値が保持されていることが確認できます
  • 21~22行目は、Preserveを付けずに変更した場合です。すべての値が破棄され、0になっていることが分かります

Preserve で変更できるのは最後の次元だけで、最初の次元を変更するとエラーになります。

ReDim Preserveで二次元配列の最後の次元は変更できるが、最初の次元を変更すると実行時エラー9になることを示す図

動的配列でインデックス番号の最小値変更方法

動的配列でもインデックス番号の最小値を変更することができます。変更方法は静的配列と同じように「最小値 To 最大値, 最小値 To 最大値」で指定できます。

ReDim a(1 To 5)
ReDim aa(1 To 3, 1 To 4)

「Option Base 1」でも最小値を「1」にできますが、モジュール内で開始の番号を省略したすべての配列に影響します。配列ごとに開始の番号がわかるように、To で指定するとよいでしょう。

エラーになるときの確認ポイント

エラー主な原因対処
実行時エラー ‘9’: インデックスが有効範囲にありません。宣言した範囲の外の番号を指定しているループの範囲を UBound、LBound で指定する
同上動的配列に ReDim を実行する前に要素を使っている先に ReDim で要素数を決める
コンパイルエラー:定数式が必要です。Dim a(n) As Long のように、宣言に変数を使っている動的配列で宣言し、ReDim a(n) とする
コンパイルエラー:配列は既に宣言されています。静的配列に ReDim を実行しているDim a() As Long と宣言し直す

まとめ(おわりに)

くるみこ

今回は配列について解説しました。配列には静的配列と動的配列がありますが、どちらも非常に使用頻度が高いと思います。動的配列をうまく利用することができるようになれば、複雑なプログラミングもできますしコードも簡素化できる場合もあります。 どうですか、理解できましたか?

はい! 静的配列と動的配列の違いなどは理解できました(^^)
でも、使いこなせるようになるまでしっかり復習しなくちゃだめですね!

くるみこ

配列は奥が深いのでしっかり頑張ってくださいね(^^)/
では、次回は配列を使いこなしていくために、知っておいた方が良いことをさらに解説していきたいと思います!

まとめと感想など

まとめ
  • 配列とは、同じデータ型のデータを1つにまとめた変数のことです
  • 配列内のデータは「インデックス番号」付きで格納されます
  • 配列を構成する1つ1つの変数は「要素」と呼ばれています
  • 配列には「静的配列」と「動的配列」があり、使用には宣言が必要です
  • 配列の宣言は「Dim 配列名(インデックス最大値) As データ型」で行います
  • 配列のインデックスは指定しない場合は「0」から始まります
  • 開始インデックスを変更する場合は「Option Base」で指定するか、「開始インデックス To 終了インデックス」と宣言します
  • 要素数は UBound関数と LBound関数で調べられます
  • ReDimステートメントで動的配列の要素数を設定します
  • ReDim Preserveで値を保持したまま要素数を変更できますが、変更できるのは最後の次元だけです

・マクロ(VBA)を実行する際は必ずバックアップを取ってから行ってください!
・マクロ(VBA)は実行後にファイルを保存すると元に戻すことはできません!
・実行後にファイルを保存せず終了すれば、実行前に戻すことができます!

関連記事

今後の記事について

今回の記事はいかがだったでしょうか。皆さまのお役に立てたなら幸いです(^^;
当面は「初心者向けマクロVBA」の記事を継続して書いていきます。

【検討中の今後の記事内容は・・・・・】
・実務に役立つものを提供できるよう現在検討中です
・その他雑記的に「小ネタなどいろいろ」・・・・・
・今後の記事にもご期待ください(^^)/

記事のサンプルファイルをダウンロードできます

この記事のサンプルはこのリンク先からダウンロードできます!
Sample01 から Sample08 までを収録しています。

過去の記事で使用したサンプルファイルがダウンロードできるページを設置しています
こちら(このリンク先)からご利用ください

よかったらシェアしてね!
  • URLをコピーしました!
目次