Array 関数Array function

配列を含む Variant を返します。Returns a Variant containing an array.



必須の arglist 引数は、Variant に含まれている配列の要素に割り当てられる値のコンマ区切りのリストです。The required arglist argument is a comma-delimited list of values that are assigned to the elements of the array contained within the Variant. 引数を指定しない場合は長さ 0 の配列が作成されます。If no arguments are specified, an array of zero length is created.


配列の要素を参照するために使用される表記は、変数 名とそれに続く括弧で構成され、括弧の中には目的の要素を示すインデックス番号が入ります。The notation used to refer to an element of an array consists of the variable name followed by parentheses containing an index number indicating the desired element.

次の例では、最初のステートメントにより、Variant として「A」という名前の変数が作成されます。In the following example, the first statement creates a variable named A as a Variant. 2 つ目のステートメントにより、変数 A に配列が割り当てられます。The second statement assigns an array to variable A. 最後のステートメントにより、2 つ目の配列要素に含まれる値が別の変数に割り当てられます。The last statement assigns the value contained in the second array element to another variable.

Dim A As Variant, B As Long, i As Long
A = Array(10, 20, 30)  ' A is a three element list by default indexed 0 to 2
B = A(2)               ' B is now 30
ReDim Preserve A(4)    ' Extend A's length to five elements
A(4) = 40              ' Set the fifth element's value
For i = LBound(A) To UBound(A)
    Debug.Print "A(" & i & ") = " & A(i)
Next i

Array 関数を使用して作成した配列の下限は、Array がタイプ ライブラリの名前で修飾 (VBA.Array など) されていない限り、Option Base ステートメントで指定した下限によって決まります。 タイプ ライブラリの名前で修飾されている場合は、ArrayOption Base の影響を受けません。If qualified with the type-library name, Array is unaffected by Option Base.


配列として宣言されていない Variant には、配列を含めることができます。A Variant that is not declared as an array can still contain an array. Variant 変数には、固定長の文字列とユーザー定義の型を除き、あらゆる型の配列を含めることができます。A Variant variable can contain an array of any type, except fixed-length strings and user-defined types. 配列が含まれている Variant は要素の型が Variant の配列とは概念的に異なりますが、配列要素には同じ方法でアクセスされます。Although a Variant containing an array is conceptually different from an array whose elements are of type Variant, the array elements are accessed in the same way.


この例では、 Array 関数を使用して、配列を含む Variant を返します。This example uses the Array function to return a Variant containing an array.

Dim MyWeek, MyDay
MyWeek = Array("Mon", "Tue", "Wed", "Thu", "Fri", "Sat", "Sun")
' Return values assume lower bound set to 1 (using Option Base
' statement).
MyDay = MyWeek(2)    ' MyDay contains "Tue".
MyDay = MyWeek(4)    ' MyDay contains "Thu".

関連項目See also

サポートとフィードバックSupport and feedback

Office VBA またはこの説明書に関するご質問やフィードバックがありますか?Have questions or feedback about Office VBA or this documentation? サポートの受け方およびフィードバックをお寄せいただく方法のガイダンスについては、Office VBA のサポートおよびフィードバックを参照してください。Please see Office VBA support and feedback for guidance about the ways you can receive support and provide feedback.