Item (UnicodeNamedArraylist property)

Value of named item (UnicodeNamedArraylist class)

This ReadWrite property returns or sets the value of the item that has the specified subscript name in the UnicodeNamedArraylist.

For additional comments about the Item method in collections, see Coding considerations for collections.

Syntax

%currentItem = uniNal:Item( unicode) uniNal:Item( unicode) = newItem Throws ItemNotPresent

Syntax terms

%item

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

%unamrayl

A UnicodeNamedArraylist object.

name

A Unicode string that serves as a subscript to identify a %unamrayl item.

Usage notes

• The Item keyword is not required. For example, in the request in the UnicodeNamedArraylist class example, %k('§Apr':u) = 'Leo', for instance, is equivalent to:

      %k:Item('§Apr':u) = 'Leo'
  

• If the Item property is being set and there is already an item on the UnicodeNamedArraylist that has the specified name, that item is replaced. If the Item property is being set and there is no item on the UnicodeNamedArraylist that has the indicated name, the item is added. If the Item property is being retrieved and there is no item on the UnicodeNamedArraylist that has the indicated name, the result is one of the following actions:
  • The request is cancelled if the UseDefault property value is False.
  • The Default value is returned if the UseDefault property is True.
• As shown in the example in the UnicodeNamedArraylist class article, UnicodeNamedArraylist items are ordered alphabetically by their subscript names. Accordingly, the Item method takes a Unicode string name argument. The ItemByNumber method, described below, lets you retrieve or set an item using the item's ordinal number. The NameByNumber function lets you retrieve or set an item using the item's subscript name.

See also

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