Method

Insert


Warning

This item was deprecated in version 2019r2. Please use Arrays.AddAt as a replacement.

Description

Inserts a new element into an array. Arrays are zero-based.

Usage

array.Insert index, value

Part

Type

Description

array

array of any valid data type

The array in which to insert the new element.

index

Integer

The position in array to insert the new element, i.e., the index of the new element.

value

Datatype of array

The value to be assigned to the new array element.

Notes

The Insert method works with one-dimensional arrays only.

All arrays are indexed starting at position 0. Arrays can have a maximum index value of 2,147,483,646.

Sample code

Suppose array "a" is defined as:

a = Array("Leonard", "Adolph", "Herbert")

The statement:

a.Insert(2, "Bill")

Compatibility

All project types on all supported operating systems.

See also

Arrays, Array, Arrays.IndexOf, Redim, Arrays, Shuffle, Sort methods; Dim, Redim statements; Arrays.LastIndex function; Arrays concept