Array Function

Returns a Variant containing an array.

                      Array(
                      arglist
                      )
                    

Remarks

The required arglist argument is a comma-delimited list of values that are assigned to the elements of an array contained with the Variant. 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.

All arrays in Visual Basic Scripting Edition (VBScript) are zero-based.

The Array function is used to create single-dimension arrays. For information about multi-dimensional arrays, see VBScript Variables.

Note

A variable that is not declared as an array can still contain an array. Although a Variant variable containing an array is conceptually different from an array variable containing Variant elements, the array elements are accessed in the same way.

Example

The following example illustrates the use of the Array function.

' Create a single-dimension array and assign three elements.
Dim A
A = Array(10,20,30)
' Set B to the third element in the array (which is 30).
' The array is zero-based.
B = A(2)

Requirements

Version 2

See Also

Reference

Dim Statement

ReDim Statement

IsArray Function

LBound Function

UBound Function

Private Statement

Public Statement

Erase Statement

Change History

Date

History

Reason

April 2009

Added information to remarks and added comments to the example.

Customer feedback.