NameByNumber (NamedArraylist function)

From m204wiki
Revision as of 17:28, 4 February 2011 by Wiccan (talk | contribs) (1 revision)
Jump to navigation Jump to search

<section begin=dpl_desc/>Name of specified item<section end=dpl_desc/>

NameByNumber is a member of the NamedArraylist class.

This ReadOnly property returns the name of the item that has the indicated item number in the NamedArraylist.

Syntax

%name = %namrayl:NameByNumber(number)

Syntax terms

%name A string variable to contain the name of the namrayl item that is specified by number.
%namrayl A NamedArraylist object.
number A whole number greater than 0 to identify a %namrayl item by its position (item number) in the alphabetically ordered NamedArraylist. If number is greater than the number of items in %namrayl, or if it is less than or equal to zero, the request is cancelled.

Usage Notes

  • If the NameByNumber property is being retrieved and there is no item on the NamedArraylist that has the indicated item number, the result is one of the following actions:
    • The request is cancelled if the UseDefault property is False.
    • The [Default (NamedArraylist property)|Default]] value is returned if the UseDefault property is True.
  • The Number property lets you retrieve an item using its item number.