Insert (Arraylist function)

From m204wiki
Revision as of 02:29, 20 January 2011 by Wiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

Insert items into Arraylist (Arraylist class)

Insert is a member of the Arraylist class.

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

Syntax

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

Syntax terms

%num A numeric variable to contain the number of items in the indicated Arraylist after the item has been inserted.
al An Arraylist object.
number A whole number greater than 0 to identify an al item.
item A value or variable of the same type as specified on the al declaration, or a value or variable convertible to that type.

Usage notes

  • 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.