ItemByNumber (GenericNamedArraylist property): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (1 revision)
mNo edit summary
 
(4 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Template:GenericNamedArraylist:ItemByNumber subtitle}}
{{Template:GenericNamedArraylist:ItemByNumber subtitle}}


This ReadWrite property returns or sets the NamedArraylist item that has
<var>ItemByNumber</var> is a ReadWrite property that returns or sets the <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item that has the specified ordinal item number.
the specified item number.
 
==Syntax==
==Syntax==
{{Template:GenericNamedArraylist:ItemByNumber syntax}}
{{Template:GenericNamedArraylist:ItemByNumber syntax}}
===Syntax terms===
===Syntax terms===
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%item</th>
<tr><th>%currentItem</th>
<td>A variable of the same type as specified on the ''%namrayl'' declaration to contain the value of the specified ''%namrayl'' item. Or a variable or value of the same type as specified on the ''%namrayl'' declaration to be assigned to the specified ''%namrayl'' item. </td></tr>
<td>A variable of the same type as specified on the <var class="term">anyNal</var> declaration to contain the value of the specified <var class="term">anyNal</var> item.</td></tr>
<tr><th>%namrayl</th>
<tr><th>anyNal</th>
<td>A NamedArraylist object. </td></tr>
<td>A <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> object. </td></tr>
<tr><th>number</th>
<tr><th>number</th>
<td>A whole number greater than 0 to identify a ''%namrayl'' item by its position 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 <var class="term">anyNal</var> item by its position in the ordered <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var>. If <var class="term">number</var> is greater than the number of items in <var class="term">anyNal</var>, or if it is less than or equal to zero, the request is cancelled.</td></tr>
<tr><th>newItem</th>
<td>A variable or value of the same type as specified on the <var class="term">anyNal</var> declaration to be assigned to the specified <var class="term">anyNal</var> item. </td></tr>
</table>
</table>
==Usage notes==
<ul>
<li>If the ItemByNumber property is being set and there is already an item
on the NamedArraylist that has the specified number, that item is replaced.
If the ItemByNumber property is being set and there is no item on the
NamedArraylist that has the indicated number, the item is added.


If the ItemByNumber property is being retrieved and there is no item on the
NamedArraylist that has the indicated number,
the result is one of the following actions:
<ul>
<li>The request is cancelled if the
[[UseDefault (NamedArraylist property)|UseDefault]] property value is <tt>False</tt>.
<li>The [[Default (NamedArraylist property)|Default]] value is returned if the
UseDefault property is <tt>True</tt>.
</ul>
<li>The [[Item (NamedArraylist property)|Item]] property lets you retrieve or
set an item using its item name.
</ul>
==See also==
==See also==
<ul><li>The <var>Item</var> properties for <var>[[Item_(FloatNamedArraylist_property)|FloatNamedArraylist]]</var>, <var>[[Item (NamedArraylist property)|NamedArraylist]]</var>, and <var>[[Item_(UnicodeNamedArraylist_property)|UnicodeNamedArraylist]]</var> respectively, let you retrieve or set an item using its item key.</ul>
{{Template:GenericNamedArraylist:ItemByNumber footer}}
{{Template:GenericNamedArraylist:ItemByNumber footer}}

Latest revision as of 03:18, 8 August 2012

Return or set item using item number (FloatNamedArraylist, NamedArraylist, and UnicodeNamedArraylist classes)


ItemByNumber is a ReadWrite property that returns or sets the FloatNamedArraylist, NamedArraylist, or UnicodeNamedArraylist item that has the specified ordinal item number.

Syntax

%currentItem = anyNal:ItemByNumber( number) anyNal:ItemByNumber( number) = newItem

Syntax terms

%currentItem A variable of the same type as specified on the anyNal declaration to contain the value of the specified anyNal item.
anyNal A FloatNamedArraylist, NamedArraylist, or UnicodeNamedArraylist object.
number A whole number greater than 0 to identify a anyNal item by its position in the ordered FloatNamedArraylist, NamedArraylist, or UnicodeNamedArraylist. If number is greater than the number of items in anyNal, or if it is less than or equal to zero, the request is cancelled.
newItem A variable or value of the same type as specified on the anyNal declaration to be assigned to the specified anyNal item.

See also