Insert

From Xojo Documentation

Revision as of 19:05, 3 September 2020 by THill (talk | contribs) (Text replacement - "{{Deprecated|" to "{{DeprecatedItem|")
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