Item (Arraylist property)

<section begin=dpl_desc/>Return or set Arraylist item value<section end=dpl_desc/>

Item is a member of the Arraylist class.

This ReadWrite property returns or sets the indicated item in the Arraylist.

For additional description of this method, see Coding considerations for collections.

Syntax

  %item = %arrayl:Item(number)

  %arrayl:Item(number) = %item

Syntax Terms

%item

A variable of the same type as specified on the %arrayl declaration to contain the value of the specified %arrayl item. Or a variable or value of the same type as specified on the %arrayl declaration to be assigned to the specified %arrayl item.

%arrayl

An Arraylist object.

number

A whole number greater than 0 to identify an %arrayl item by its position in the arraylist. If number is greater than the number of items in the %arrayl, or if it is less than or equal to zero, the request is cancelled.

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)
  

• Methods are available to retrieve or seet the first or just the last item in an Arraylist. See FirstItem and LastItem.