Xojo Documentation Xojo Documentation

Method

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")

results in the following array:

Array Element
Leonard
Adolph
Bill
Herbert

See Also

Append, Array, IndexOf, Pop, Redim, Remove, Shuffle, Sort, Sortwith methods; Dim, Redim statements; UBound function; Arrays concept