Insert (Arraylist function)

Insert items into Arraylist (Arraylist class)

This callable function inserts an item before the number item in the Arraylist.

Syntax

[%count =] al:Insert( number, itemList)

%count	An, optional, numeric variable to return the number of items in the indicated `Arraylist` after the item has been inserted.
al	An `Arraylist` object.
number	A whole number, from 1 to the number of items in `al` plus one, to identify an `al` item *before* which `collectionItem` will be inserted.
collectionItem	A value or variable of the same type as specified on the `al` declaration, or a value or variable convertible to that type; to be inserted into `al`.

If number is less than or equal to the number of items in the Arraylist, the new item is inserted before the indicated item.
If number is equal to the number of items in the Arraylist plus one, the new item is added to the end of the Arraylist.
If number is greater than the number of items in the Arraylist plus one, or less than or equal to zero, the request is cancelled.
For an example using the Insert method, see Arraylist class.

Arraylist class FloatNamedArraylist class NamedArraylist class UnicodeNamedArraylist class	List of Arraylist methods List of FloatNamedArraylist methods List of NamedArraylist methods List of UnicodeNamedArraylist methods List of Collection methods	Arraylist methods syntax FloatNamedArraylist methods syntax NamedArraylist methods syntax UnicodeNamedArraylist methods syntax
Notation conventions for methods