Documentation Excel VBA

概要

IsArray関数は、VBAで指定した変数が配列であるかどうかを判定するために使用される関数です。配列はデータの集合を扱う際に非常に便利な構造ですが、変数が配列かどうかを事前に確認することで、意図しないエラーを防ぎ、コードの信頼性を高めることができます。本記事では、IsArray関数の使い方や実用的な使用例を紹介します。

構文

IsArray(varname)

パラメータ

  • varname

    判定したい変数を指定します。この変数が配列であるかどうかをチェックします。

戻り値

  • True：指定した変数が配列の場合。

  • False：指定した変数が配列でない場合。

使用例

基本的な使用例 - 配列かどうかを判定する

以下の例では、IsArray関数を使用して、変数が配列かどうかを判定し、その結果をメッセージボックスで表示します。

Sub CheckIfArray()
    Dim sampleArray() As Integer
    Dim sampleVariable As Integer

    ' 配列を初期化
    ReDim sampleArray(1 To 5)

    ' 配列かどうかを判定
    If IsArray(sampleArray) Then
        MsgBox "sampleArrayは配列です。"
    Else
        MsgBox "sampleArrayは配列ではありません。"
    End If

    ' 通常の変数で判定
    If IsArray(sampleVariable) Then
        MsgBox "sampleVariableは配列です。"
    Else
        MsgBox "sampleVariableは配列ではありません。"
    End If
End Sub

この例では、IsArray関数を使用して、sampleArrayが配列であるかどうかを確認し、結果を表示しています。sampleVariableは単一の変数なので、配列ではないことが確認できます。

オブジェクト型の配列判定例

オブジェクト型の変数にもIsArray関数を使用できます。以下の例では、Variant型の変数を使って配列の判定を行います。

Sub CheckObjectArray()
    Dim objArray As Variant
    Dim notArray As Variant

    ' Variant型の配列を作成
    objArray = Array(1, 2, 3)

    ' Variant型の通常の値を代入
    notArray = 10

    ' 配列かどうかを判定
    If IsArray(objArray) Then
        MsgBox "objArrayは配列です。"
    Else
        MsgBox "objArrayは配列ではありません。"
    End If

    ' 配列かどうかを判定
    If IsArray(notArray) Then
        MsgBox "notArrayは配列です。"
    Else
        MsgBox "notArrayは配列ではありません。"
    End If
End Sub

この例では、Variant型のobjArrayが配列であることが確認されます。一方、notArrayは単一の値を持っているため、配列ではないことが判定されます。

動的配列の判定例

動的配列の判定もIsArray関数を使用して行えます。以下のコードは、配列が動的に作成されたかどうかを確認します。

Sub CheckDynamicArray()
    Dim dynamicArray() As String

    ' 動的配列の判定（未初期化の状態）
    If IsArray(dynamicArray) Then
        MsgBox "dynamicArrayは配列です。（未初期化）"
    End If

    ' 動的配列を初期化
    ReDim dynamicArray(1 To 10)

    ' 配列かどうかを再判定
    If IsArray(dynamicArray) Then
        MsgBox "dynamicArrayは配列です。（初期化済み）"
    End If
End Sub

この例では、ReDimを使用して動的に配列を作成し、その後で配列であることを確認しています。初期化前と後での判定がどちらも配列であると表示されますが、動的配列であるかどうかを見分ける助けとなります。

使用時の注意点

  • オブジェクト型の配列判定

    IsArray関数はVariant型やオブジェクト型にも使用できますが、変数の内容や構造によっては意図しない結果が返ることもあります。配列の操作を行う前に確認を行い、エラー処理を組み込むことが重要です。

  • 未初期化の動的配列

    動的配列がReDimなどで初期化される前であっても、IsArrayはTrueを返します。この点に注意し、配列の内容を利用する際にはさらに詳細な確認が必要です。

まとめ

IsArray関数は、VBAで変数が配列かどうかを確認するために便利な関数です。配列の存在確認や安全な操作の前提条件として利用することで、プログラムの安定性を向上させることができます。配列の確認が必要なシナリオで活用し、コードの信頼性を高めましょう。

参照:

IsArray関数（Visual Basic for Applications） | Microsoft Learn
円