なぜ、配列を引数として渡すことが重要なのか?
実務でVBAを書いていると、大量のデータを処理する際に「配列」は欠かせない存在です。しかし、処理が複雑になるほど、一つのプロシージャ(SubやFunction)が肥大化し、可読性が落ちてしまいます。処理を細分化し、それぞれのパーツを独立させるために、配列を引数として別のプロシージャに渡す技術は、中級者へのステップアップに必須のスキルです。これを使えば、汎用的な「データ加工用プロシージャ」を一つ作っておき、複数の場所から使い回すといった効率的な開発が可能になります。
基礎知識:引数で配列を受け渡すルール
VBAにおいて、配列を引数として渡すには決まった記述ルールがあります。特に重要なのは、受け手側の引数名の後ろに括弧()を付けることです。これにより、VBAは「この引数はただの変数ではなく、配列である」と認識します。
・呼び出し側:Call プロシージャ名(配列名)
・受け手側:Sub プロシージャ名(配列名() As データ型)
この際、データ型を合わせることも重要です。例えば、String型の配列を渡すなら、受け手側の引数もString型で定義する必要があります。
実装のポイント
実務では、配列のサイズが可動的(動的配列)であることも多いでしょう。その際、受け手側で配列の範囲を特定するために、LBound関数(下限値)とUBound関数(上限値)を使うのが定石です。これにより、配列の要素数が変わっても、コードを書き換えることなく柔軟に対応できます。
サンプルプログラム:実務で使える配列受け渡しテンプレート
以下のコードは、メイン処理で作成したデータを、計算用のプロシージャへ引き渡す例です。
Sub MainProcess()
‘ 配列を定義(要素数5の動的配列)
Dim myData(0 To 4) As Double
Dim i As Long
‘ テストデータを作成
For i = LBound(myData) To UBound(myData)
myData(i) = (i + 1) 10
Next i
‘ 配列を引数として渡す
Call CalculateData(myData)
End Sub
‘ 配列を受け取って合計を計算するプロシージャ
Sub CalculateData(targetArray() As Double)
Dim total As Double
Dim i As Long
‘ 配列のサイズを意識せず、LBound/UBoundでループする
For i = LBound(targetArray) To UBound(targetArray)
total = total + targetArray(i)
Next i
MsgBox “配列の合計値は:” & total & ” です。”
End Sub
応用・注意点:現場で陥りやすいバグを防ぐ
1. 型の一致に注意する:Variant型で配列を受け取ることも可能ですが、メモリ効率やバグの発見しやすさを考えると、可能な限り具体的な型(DoubleやStringなど)を指定することをおすすめします。
2. 配列の次元数:受け手側で定義した括弧内にカンマがない場合(例:myArg())、VBAは1次元配列を期待します。多次元配列を扱う場合は、Sub RecArg(myArg(,) As Double)のように、カンマを入れて次元数を明示する必要があります。
3. 参照渡しと値渡し:デフォルトでは配列は「参照渡し(元の配列を書き換えることが可能)」になります。もし、渡した先のプロシージャで配列の中身を誤って書き換えたくない場合は、処理の冒頭で別の配列変数にコピーを取るなどの工夫を行いましょう。
このテクニックをマスターすれば、コードのメンテナンス性が劇的に向上します。ぜひ、複雑なマクロの整理に役立ててください。
