Add (Arraylist function) - Revision history

JAL at 15:25, 1 November 2012

2012-11-01T15:25:44Z

← Older revision		Revision as of 15:25, 1 November 2012
Line 22:		Line 22:
	Each of these, from left to right, becomes an item or items in the method object <var>Arraylist</var>.		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> is only a single item to be added to <var class="term">al</var>: 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.</td></tr>		Under <var class="product">Sirius Mods</var> 7.8 and earlier, <var class="term">itemList</var> is only a single item to be added to <var class="term">al</var>: 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.</td></tr>
	</table>		</table>

Line 35:		Line 35:
	For more examples of <var>Add</var> calls, see [[Arraylist class\|"Arraylist class"]].		For more examples of <var>Add</var> calls, see [[Arraylist class\|"Arraylist class"]].

	===Adding numbers to an Arraylist===		====Adding numbers to an Arraylist====
	In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is added to an <var>Arraylist</var>:		In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is added to an <var>Arraylist</var>:
	<p class="code">b		<p class="code">b
Line 66:		Line 66:
	12: 23		12: 23
	</p>		</p>
	===Adding objects to an Arraylist===
			====Adding objects to an Arraylist====
	In the following example, a new object, an object variable and another <var>Arraylist</var> of objects is added to an <var>Arraylist</var>:		In the following example, a new object, an object variable and another <var>Arraylist</var> of objects is added to an <var>Arraylist</var>:
	<p class="code">b		<p class="code">b

JAL2 at 20:06, 20 July 2012

2012-07-20T20:06:59Z

← Older revision		Revision as of 20:06, 20 July 2012
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:Arraylist:Add syntax}}		{{Template:Arraylist:Add syntax}}

	===Syntax terms===		===Syntax terms===
	<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 items have 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>		<td>An, optional, numeric variable that returns the number of items in the indicated <var>Arraylist</var> after the items have 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>itemList</th>		<tr><th>itemList</th>
	<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~~>.		<td>Under <var class="product">Sirius Mods</var> 7.9 and later, this is a comma-delimited set of a combination of one or more of these:
			<ul>
			<li>Values or variables of the same type as specified on the <var class="term">al</var> declaration
			<li>Collections of objects of the same type as specified on the <var class="term">al</var> declaration
			</ul>

	~~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.~~		Each of these, from left to right, becomes an item or items in the method object <var>Arraylist</var>.

	~~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>~~

			Under <var class="product">Sirius Mods</var> 7.8 and earlier, <var>itemList</var> is only a single item to be added to <var class="term">al</var>: 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.</td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul><li>The <var>[[Push (Arraylist function)\|Push]]</var> and <var>[[Enqueue (Arraylist function)\|Enqueue]]</var> functions are the same as the <var>Add</var> function with the exception that <var>Push</var> and <var>Enqueue</var> can only add a single item to the target <var>Arraylist</var> while (under <var class="product">Sirius Mods</var> 7.9 and later) <var>Add</var> can add many items to the target <var>Arraylist</var>:		<ul><li>The <var>[[Push (Arraylist function)\|Push]]</var> and <var>[[Enqueue (Arraylist function)\|Enqueue]]</var> functions are the same as the <var>Add</var> function, with the exception that <var>Push</var> and <var>Enqueue</var> can only add a single item to the target <var>Arraylist</var>, while (under <var class="product">Sirius Mods</var> 7.9 and later) <var>Add</var> can add many items to the target <var>Arraylist</var>:
	<ul>		<ul>
	<li><var>Push</var> was designed as a convenience for use with the <var>[[Pop (Arraylist function)\|Pop]]</var> function.		<li><var>Push</var> was designed as a convenience for use with the <var>[[Pop (Arraylist function)\|Pop]]</var> function.
Line 27:		Line 33:

	==Examples==		==Examples==
	For more examples of <var>Add</var> calls, see [[Arraylist class]].		For more examples of <var>Add</var> calls, see [[Arraylist class\|"Arraylist class"]].

	===Adding numbers to an Arraylist===		===Adding numbers to an Arraylist===
	In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is added to an <var>Arraylist</var>:		In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is added to an <var>Arraylist</var>:

JAL2 at 21:01, 18 July 2011

2011-07-18T21:01:28Z

← Older revision		Revision as of 21:01, 18 July 2011
Line 1:		Line 1:
	{{Template:Arraylist:Add subtitle}}		{{Template:Arraylist:Add subtitle}}
	~~<var>Add</var>~~ adds an item to the end of an <var>Arraylist</var>.		This [[Notation conventions for methods#Callable functions\|callable]] function adds an item to the end of an <var>Arraylist</var>.

	==Syntax==		==Syntax==

Curly: /* Syntax terms */

2011-03-14T20:11:36Z

Syntax terms

← Older revision		Revision as of 20:11, 14 March 2011
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 last or only 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 items have 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>

Alex: /* Usage notes */

2011-03-14T02:37:26Z

Usage notes

← Older revision		Revision as of 02:37, 14 March 2011
Line 20:		Line 20:

	==Usage notes==		==Usage notes==
	<ul><li>The <var>[[Push (Arraylist function)\|Push]]</var> and <var>[[Enqueue (Arraylist function)\|Enqueue]]</var> functions are the same as the <var>Add</var> function:		<ul><li>The <var>[[Push (Arraylist function)\|Push]]</var> and <var>[[Enqueue (Arraylist function)\|Enqueue]]</var> functions are the same as the <var>Add</var> function with the exception that <var>Push</var> and <var>Enqueue</var> can only add a single item to the target <var>Arraylist</var> while (under <var class="product">Sirius Mods</var> 7.9 and later) <var>Add</var> can add many items to the target <var>Arraylist</var>:
	<ul>		<ul>
	<li><var>Push</var> was designed as a convenience for use with the <var>[[Pop (Arraylist function)\|Pop]]</var> function.		<li><var>Push</var> was designed as a convenience for use with the <var>[[Pop (Arraylist function)\|Pop]]</var> function.

Alex: /* Examples */

2011-03-14T02:34:14Z

Examples

@@ Line 27: / Line 27: @@
 ==Examples==
-For examples of <var>Add</var> calls, see [[Arraylist class]].
+For more examples of <var>Add</var> calls, see [[Arraylist class]].
 ==See also==
 {{Template:Arraylist:Add footer}}

Alex: /* Syntax terms */

2011-03-14T02:18:36Z

Syntax terms

← Older revision		Revision as of 02:18, 14 March 2011
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>

Goff: call that consistent, this is consistent

2011-03-11T06:37:06Z

call that consistent, this is consistent

← Older revision		Revision as of 06:37, 11 March 2011
Line 1:		Line 1:
	{{Template:Arraylist:Add subtitle}}		{{Template:Arraylist:Add subtitle}}
			<var>Add</var> adds an item to the end of an <var>Arraylist</var>.
	<p>~~This callable function~~ adds an item to the end of an Arraylist.</p>

	==Syntax==		==Syntax==
Line 12:		Line 11:
	<td>An <var>Arraylist</var> object. </td></tr>		<td>An <var>Arraylist</var> object. </td></tr>
	<tr><th>collectionItem</th>		<tr><th>collectionItem</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.</td></tr>		<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>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul><li>The <var>[[Push (Arraylist function)\|Push]]</var> and <var>[[Enqueue (Arraylist function)\|Enqueue]]</var> functions are the same as the <var>Add</var> function:		<ul><li>The <var>[[Push (Arraylist function)\|Push]]</var> and <var>[[Enqueue (Arraylist function)\|Enqueue]]</var> functions are the same as the <var>Add</var> function:

Goff: apply Dave's suggestions

2011-02-23T07:52:15Z

apply Dave's suggestions

← Older revision		Revision as of 07:52, 23 February 2011
Line 15:		Line 15:
	</table>		</table>
	==Usage notes==		==Usage notes==
	<ul><li>The [[Push (Arraylist function)\|Push]] and		<ul><li>The <var>[[Push (Arraylist function)\|Push]]</var> and <var>[[Enqueue (Arraylist function)\|Enqueue]]</var> functions are the same as the <var>Add</var> function:
	[[Enqueue (Arraylist function)\|Enqueue]] functions are the same as the <var>Add</var> function:
	<ul>		<ul>
	<li>Push was designed as a convenience for use with the [[Pop (Arraylist function)\|Pop]] function.		<li><var>Push</var> was designed as a convenience for use with the <var>[[Pop (Arraylist function)\|Pop]]</var> function.
	<li>Enqueue was designed as a convenience for use with the		<li><var>Enqueue</var> was designed as a convenience for use with the <var>[[Dequeue (Arraylist function)\|Dequeue]]</var> function.
	[[Dequeue (Arraylist function)\|Dequeue]] function.
	</ul></ul>		</ul></ul>

Wiccan: 1 revision

2011-02-01T21:15:16Z

1 revision

← Older revision	Revision as of 21:15, 1 February 2011
(No difference)