
VBAで「ByRef」と「ByVal」を省略して意図しない副作用を生んではいけない理由
「関数に渡した変数が、関数を呼んだ後も勝手に書き換わっている」——この現象に心当たりはありませんか。原因は、VBAの引数が既定で`ByRef`(参照渡し)になっていることを知らずにコードを書いていることかもしれません。
引数を省略すると何が起きるか
Sub Main()
Dim total As Long
total = 100
AddTax total
Debug.Print total ' → 110(呼び出し元の値まで変わっている)
End Sub
Sub AddTax(amount As Long)
amount = amount * 1.1
End Sub`AddTax`プロシージャの引数`amount`に`ByRef`も`ByVal`も明記していない場合、VBAは既定で`ByRef`(参照渡し)として扱います。その結果、`AddTax`の中で`amount`を書き換えると、呼び出し元の`total`変数そのものまで変わってしまいます。
「関数の中だけで完結する一時的な計算のつもりが、呼び出し元の値まで変えてしまう」——これが、`ByRef`を意識せずにコードを書くことの危険性です。
ByRefとByValの違い
| キーワード | 動作 |
|-----------|------|
| ByRef(参照渡し) | 呼び出し元の変数そのものを渡す。関数内での変更が呼び出し元にも反映される |
| ByVal(値渡し) | 呼び出し元の変数の値だけをコピーして渡す。関数内での変更は呼び出し元に影響しない |
VBAでは、`ByRef`を明記しなかった場合、既定でByRefとして扱われます。この「書かなければByRefになる」という仕様を知らないまま使い続けると、意図しない副作用を生む原因になります。
正しい書き方:意図を明示する
呼び出し元に影響させたくない場合はByValを明記する
Sub Main()
Dim total As Long
total = 100
Dim result As Long
result = CalculateTaxIncluded(total)
Debug.Print total ' → 100(変わらない)
Debug.Print result ' → 110
End Sub
Function CalculateTaxIncluded(ByVal amount As Long) As Long
amount = amount * 1.1
CalculateTaxIncluded = amount
End Function`ByVal`を明記しておけば、関数内で`amount`をどう書き換えても、呼び出し元の`total`には一切影響しません。「関数内だけで完結する一時的な計算」を行いたい場合は、常に`ByVal`を明記する習慣をつけるべきです。
意図的に呼び出し元を書き換えたい場合はByRefを明記する
Sub IncrementCounter(ByRef counter As Long)
counter = counter + 1
End Sub逆に、「呼び出し元の変数を直接書き換えたい」という意図がある場合は、`ByRef`を省略せず、明示的に書いておくことで、読み手に「この引数は書き換わる」ということが伝わります。
オブジェクト型引数での注意点
Range・Worksheet・Collectionのようなオブジェクト型の引数は、`ByVal`で渡しても、オブジェクトのプロパティ・メソッドを使った操作(セルへの値設定など)は呼び出し元にも反映されます。`ByVal`/`ByRef`の違いが影響するのは、「関数内で`Set 引数 = 別のオブジェクト`のように、引数の参照先そのものを差し替えた場合」に限られます。
Sub ClearSheet(ByVal ws As Worksheet)
ws.Cells.Clear ' ByValでも、このセル操作は呼び出し元に反映される
End Subこの性質を理解していないと、「ByValにしたのに値が変わった」と混乱する原因になります。
実務での習慣化
' 悪い例:引数の型指定だけで、ByRef/ByValを省略している
Function Calculate(amount As Long) As Long
' 良い例:常に明示する
Function Calculate(ByVal amount As Long) As Longすべての引数に`ByRef`/`ByVal`を明示的に書く習慣をつけておくことで、「この引数は書き換わるのか、書き換わらないのか」をコードを読むだけで判断できるようになります。
まとめ
| 状況 | 推奨 |
|------|------|
| 呼び出し元に影響させたくない | ByValを明記する |
| 呼び出し元の値を意図的に書き換えたい | ByRefを明記する |
| とりあえず省略する | 既定でByRefになり、意図しない副作用を招くリスクがある |
VBAの「引数を省略するとByRefになる」という仕様は、知らないまま使い続けると、呼び出し元の値が意図せず書き換わるバグの温床になります。すべての引数に`ByRef`/`ByVal`を明示する習慣が、予測可能で安全なコードへの第一歩です。
もしこの記事が役に立ったら、スキ♡をポチっとしていただけると励みになります。
IT実務ラボでは「なぜそうするか」まで掘り下げたExcel・VBA実務記事を継続的にお届けしています。次の記事を見逃さないために、ぜひフォローをお願いします。
IT実務ラボ|「なぜそうするか」の理由まで、丁寧に。