メインコンテンツへスキップ
見出し画像
Photo byfee_dragee

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実務ラボ|「なぜそうするか」の理由まで、丁寧に。

     
     
    実務ノウハウを発信しています。「なぜそうするか」の理由まで丁寧に解説。無料記事でExcelの基礎から、有料記事でVBAの実践的な設計思想まで。ITツールを使った業務効率化も発信中。

    あなたへのおすすめ