Item (Arraylist property)

From m204wiki
Jump to navigation Jump to search

Return or set Arraylist item value (Arraylist class)

Item is a ReadWrite property that returns or sets the indicated item in the Arraylist. For additional description of this method, see "Coding considerations for collections".

Syntax

%currentItem = al:Item( number) al:Item( number) = newItem

Syntax terms

%currentItem A variable of the same type as specified on the al declaration to contain the value of the specified al item.
al An Arraylist object.
number A whole number greater than 0 to identify an al item by its position within the arraylist. If number is greater than the number of items in the al, or if it is less than or equal to zero, the request is cancelled.
newItem A value of the same type as specified on the al declaration to be assigned to the specified al item.

Usage notes

  • The Item keyword is not required. For instance, in the For loop in the Arraylist class example, print %alist(%i) is equivalent to:

    print %alist:Item(%i)

  • Explicitly references to retrieve or set just the first or last item in an Arraylist can be done via FirstItem or LastItem respectively.

See also