Add (Arraylist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (call that consistent, this is consistent)
Line 7: Line 7:
<table class="syntaxTable">
<table class="syntaxTable">
<tr><th>%count</th>
<tr><th>%count</th>
<td>An, optional, numeric variable that returns the number of items in the indicated <var>Arraylist</var> after the item has been added. <var class="term">%count</var> is also the item number associated with the added item in the <var>Arraylist</var>. </td></tr>
<td>An, optional, numeric variable that returns the number of items in the indicated <var>Arraylist</var> after the item has been added. <var class="term">%count</var> is also the item number associated with the last or only added item in the <var>Arraylist</var>. </td></tr>
<tr><th>al</th>
<tr><th>al</th>
<td>An <var>Arraylist</var> object. </td></tr>
<td>An <var>Arraylist</var> object. </td></tr>
<tr><th>collectionItem</th>
<tr><th>itemList</th>
<td>A value or variable of the same type as specified on the <var class="term">al</var> declaration, or a value or variable convertible to that type;to be added to the <var class="term">al</var> <var>Arraylist</var> object.</td></tr>
<td>Under <var class="product">Sirius Mods</var> 7.9 and later this can be a comma-delimited set of values or variables of the same type as specified on the <var class="term">al</var> declaration or collections of objects of the same type as specified on the <var class="term">al</var> declaration. Each of these, from left to right, becomes an item or items in the method object <var>Arraylist</var>.
 
Under <var class="product">Sirius Mods</var> 7.8 and earlier <var>itemList</var> can only be a single value or variable of the same type as specified on the <var class="term">al</var> declaration, or a value or variable convertible to that type to be added to the <var class="term">al</var> <var>Arraylist</var> object.
 
Of course, a single value or variable is just a single item list so can be specified under <var class="product">Sirius Mods</var> 7.9 and later, too.</td></tr>
 
</table>
</table>



Revision as of 02:18, 14 March 2011

Add Arraylist items (Arraylist class)

Add adds an item to the end of an Arraylist.

Syntax

[%count =] al:Add( itemList)

Syntax terms

%count An, optional, numeric variable that returns the number of items in the indicated Arraylist after the item has been added. %count is also the item number associated with the last or only added item in the Arraylist.
al An Arraylist object.
itemList Under Sirius Mods 7.9 and later this can be a comma-delimited set of values or variables of the same type as specified on the al declaration or collections of objects of the same type as specified on the al declaration. Each of these, from left to right, becomes an item or items in the method object Arraylist.

Under Sirius Mods 7.8 and earlier itemList can only be a single value or variable of the same type as specified on the al declaration, or a value or variable convertible to that type to be added to the al Arraylist object.

Of course, a single value or variable is just a single item list so can be specified under Sirius Mods 7.9 and later, too.

Usage notes

  • The Push and Enqueue functions are the same as the Add function:
    • Push was designed as a convenience for use with the Pop function.
    • Enqueue was designed as a convenience for use with the Dequeue function.

Examples

For examples of Add calls, see Arraylist class.

See also