第133回.引数の数を可変にできるパラメーター配列（ParamArray）
Subプロシージャー、Functionプロシージャーにおいて、
引数リストの数を特定せず、不定個数の引数を渡せるよう可変にしたい場合があります。
=SUM(数値1,数値2,...)
このように、最後が「,...」となっていて、いくつでも（限度はありますが）指定できる関数です。
ParamArrayキーワード（パラメーター配列）を使用します。
以下では、引数の構文と名前付き引数について確認しつつParamArrayについて解説します。
引数の構文
Function name [(arglist)] [As type]
| Optional |
省略可能です。 |
| ByVal |
省略可能です。 |
| ByRef |
省略可能です。 |
| ParamArray |
省略可能です。 |
| varname |
必ず指定します。 |
| type |
省略可能です。 |
| defaultvalue |
省略可能です。 |
ByValの値渡しとは
つまり、値渡しでは、呼び出し先で引数の値を変更しても、呼び出し元の引数は変更されません。
つまり、参照渡しでは、呼び出し先で引数の値を変更すると、呼び出し元の引数も変更されます。
名前付き引数について
先頭より、
第１引数, 第２引数, 第３引数, ・・・
と呼びます。
引数の数が多いと、何番目なのかを意識することは面倒になりますし混乱します。
そこで、
引数に名前を付けて、その名前で指定できるようにしてあります。
それが、
名前付き引数です。
名前付き引数名:=値
このように、:=で値を指定します。
ParamArrayキーワード（パラメーター配列）とは
ParamArrayキーワードは、その引数がバリアント型(Variant)の要素を持つ省略可能(Optional)な配列であることを示します。
ParamArrayキーワードの制限
ByVal,ByRefやOptionalの指定はできません。
Variant以外の型を指定した場合はエラーとなります。
ParamArray引数を指定する場合には、名前付き引数を使うことはできません。
ただし、ParamArray引数を省略する場合には名前付き引数を使う事はできます。
呼び出し時に、ParamArray引数を省略した場合
UBound関数の戻り値が-1となります。
ParamArrayキーワード（パラメーター配列）の使用例
ParamArrayだけの場合
Sub sample1()
Call sample1_sub(123, "abc", #10/7/2019#)
End Sub
Sub sample1_sub(ParamArray p())
Dim i
For i = LBound(p) To UBound(p)
Debug.Print p(i)
Next
Dim v
For Each v In p
Debug.Print v
Next
End Sub
For～とFor Each～の2通りのサンプルになります。
ParamArray引数が省略された場合は、どちらの場合もイミディエイトには何も出力されません。
他の引数がある場合
Sub sample2()
Call sample2_sub(123, 456, "abc")
End Sub
Sub sample2_sub(arg1, ParamArray p())
Dim i
For i = LBound(p) To UBound(p)
Debug.Print p(i)
Next
End Sub
ParamArray引数が省略された場合、
Call sample2_sub(123)
この場合はイミディエイトには何も出力されません。
ParamArray引数を省略した場合
Sub sample3()
Call sample3_sub
End Sub
Sub sample3_sub(ParamArray p())
If IsMissing(p) Then
Debug.Print "引数なし"
Else
Debug.Print "引数あり"
End If
If UBound(p) < LBound(p) Then
Debug.Print "引数なし"
Else
Debug.Print "引数あり"
End If
End Sub
IsMissing関数で判定するほうが良いでしょう。
UBound関数で判定する場合は、-1判定でも構いませんが、
UBound < LBoundで判定するこ方法も良いと思います。
ParamArray引数を配列で返す関数
Sub sample4()
Dim v
v = sample4_fnc(123, "abc", #10/7/2019#)
Debug.Print Join(v, ",")
End Sub
Function sample4_fnc(ParamArray p()) As Variant()
Dim i, ary
ReDim ary(LBound(p) To UBound(p))
For i = LBound(p) To UBound(p)
ary(i) = p(i)
Next
sample4_fnc = ary
End Function
ここでは配列にして返していますが、
実際は、Functionの中で配列を使って処理する場合のサンプルです。
エラーとなる記述
サイト内の関連ページ
値渡し、参照渡しについて（ByVal,ByRef）
同じテーマ「マクロVBA入門」の記事
第130回.テーブル操作の概要（ListObject）
第131回.テーブル操作のVBAコード（ListObject,DataBodyRange）
第142回.テーブル全件処理とデータ最終行（ListObject,DataBodyRange）
第127回.他のブックのマクロを実行（Runメソッド）
第128回.マクロをショートカットで起動（OnKeyメソッド）
第129回.レジストリの操作（SaveSetting,GetSetting,GetAllSettings,DeleteSetting）
第133回.引数の数を可変にできるパラメーター配列（ParamArray）
第134回.Errオブジェクトとユーザー定義エラー
第138回.外部ライブラリ（ActiveXオブジェクト）
第140回.Property {Get|Let|Set} ステートメント
第143回.WorksheetFunctionの効率的な使い方とスピル新関数の利用
新着記事NEW ・・・新着記事一覧を見る
シートコピー後のアクティブシートは何か｜ツイッター出題回答 (2023-09-19)
Excel関数の引数を省略した場合について｜ツイッター出題回答 (2023-09-14)
セル個数を返すRange.CountLargeプロパティとは｜VBA技術解説(2023-09-08)
記号を繰り返してグラフ作成（10単位で折り返す）｜ツイッター出題回答 (2023-08-28)
シートを削除：不定数のシート名に対応｜VBAサンプル集(2023-08-24)
ランクによりボイントを付ける（同順位はポイントを分割）｜ツイッター出題回答 (2023-08-22)
OneDrive使用時のThisWorkbook.Pathの扱い方｜VBA技術解説(2023-07-26)
列幅不足による###表示や指数表示を判定する｜VBA技術解説(2023-07-12)
シートを削除：不定数のシート名に対応｜VBAサンプル集(2023-07-04)
シート関数のCOUNTIFS,SUMIFS,MAXIFSと同じ処理｜Power Query（M言語）入門(2023-02-28)
アクセスランキング ・・・ ランキング一覧を見る
1.最終行の取得（End,Rows.Count）｜VBA入門
2.RangeとCellsの使い方｜VBA入門
3.繰り返し処理（For Next)｜VBA入門
4.変数宣言のDimとデータ型｜VBA入門
5.セルのコピー&値の貼り付け（PasteSpecial）｜VBA入門
6.マクロとは？VBAとは？VBAでできること｜VBA入門
7.ブックを閉じる・保存（Close,Save,SaveAs）｜VBA入門
8.並べ替え（Sort）｜VBA入門
9.Range以外の指定方法（Cells,Rows,Columns）｜VBA入門
10.条件分岐（IF）｜VBA入門
このサイトがお役に立ちましたら「シェア」「Bookmark」をお願いいたします。
記述には細心の注意をしたつもりですが、
間違いやご指摘がありましたら、「お問い合わせ」からお知らせいただけると幸いです。
掲載のVBAコードは動作を保証するものではなく、あくまでVBA学習のサンプルとして掲載しています。
掲載のVBAコードは自己責任でご使用ください。万一データ破損等の損害が発生しても責任は負いません。