NameByNumber (NamedArraylist function): Difference between revisions
Jump to navigation
Jump to search
m (1 revision) |
m (1 revision) |
||
Line 13: | Line 13: | ||
===Syntax terms=== | ===Syntax terms=== | ||
<table class="syntaxTable"> | <table class="syntaxTable"> | ||
<tr><th | <tr><th>%name</th> | ||
<td>A string variable to contain the name of the ''namrayl'' item that is specified by ''number''. </td></tr> | <td>A string variable to contain the name of the ''namrayl'' item that is specified by ''number''. </td></tr> | ||
<tr><th | <tr><th>%namrayl</th> | ||
<td>A NamedArraylist object. </td></tr> | <td>A NamedArraylist object. </td></tr> | ||
<tr><th | <tr><th>number</th> | ||
<td>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.</td></tr> | <td>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.</td></tr> | ||
</table> | </table> |
Revision as of 17:28, 4 February 2011
<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.