Insert (Arraylist function) - Revision history

JAL: add comment to example

2017-07-27T23:11:45Z

add comment to example

← Older revision		Revision as of 23:11, 27 July 2017
Line 124:		Line 124:
	3: 1		3: 1
	4: 2		4: 2
	5: 2		5: 2 </p>
	</p>		<p>
			As this example demonstrates, if a method object <var>Arraylist</var> is also in the list of items to be inserted, the content of the object is copied before the insertion, then that copy is used as the inserted item. </p>

	==See also==		==See also==
	{{Template:Arraylist:Insert footer}}		{{Template:Arraylist:Insert footer}}

JAL: add example of insert-copy-into-self

2017-07-21T19:16:38Z

add example of insert-copy-into-self

@@ Line 109: / Line 109: @@
 : coordinate: x=3, y=11
 : coordinate: x=-4, y=3
 </p>
 ==See also==
 {{Template:Arraylist:Insert footer}}

JAL: repair example

2017-07-14T18:18:02Z

repair example

← Older revision		Revision as of 18:18, 14 July 2017
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:Arraylist:Insert syntax}}		{{Template:Arraylist:Insert syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
Line 13:		Line 14:

	<tr><th>number</th>		<tr><th>number</th>
	<td>A whole number, from 1 to the number of items in <var class="term">al</var> plus one, to identify an <var class="term">al</var> item <b><i>before</i></b> which the items in <var class="term">itemList</var> will be inserted.</td></tr>		<td>A whole number ordinal, from 1 to the number of items in <var class="term">al</var> plus one, to identify an <var class="term">al</var> item <b><i>before</i></b> which the items in <var class="term">itemList</var> will be inserted.</td></tr>

	<tr><th>itemList</th>		<tr><th>itemList</th>
Line 28:		Line 29:

	==Usage notes==		==Usage notes==
	<ul> <li>If <var class="term">number</var> is less than or equal to the number of items in the <var>Arraylist</var>, the new items are inserted before the indicated item.		<ul>
	<li>If <var class="term">number</var> is equal to the number of items in the <var>Arraylist</var> plus one, the new items are added to the end of the <var>Arraylist</var>.		<li>If <var class="term">number</var> is less than or equal to the number of items in the <var>Arraylist</var>, the new items are inserted before the indicated item. </li>

			<li>If <var class="term">number</var> is equal to the number of items in the <var>Arraylist</var> plus one, the new items are added to the end of the <var>Arraylist</var>. </li>

	<li>If <var class="term">number</var> is greater than the number of items in the <var>Arraylist</var> plus one, or less than or equal to zero, the request is cancelled.		<li>If <var class="term">number</var> is greater than the number of items in the <var>Arraylist</var> plus one, or less than or equal to zero, the request is cancelled.
	</ul>		</ul>



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

	====Inserting numbers into an Arraylist====		====Inserting numbers into an Arraylist====
	In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is inserted into an <var>Arraylist</var>:		In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is inserted into an <var>Arraylist</var>:
	<p class="code">b		<p class="code">b

	%nums is arraylist of float		%nums is arraylist of float
	%perfect is float		%perfect is float
Line 50:		Line 51:
	%primes = list(2, 3, 5, 7, 11, 13, 17, 23)		%primes = list(2, 3, 5, 7, 11, 13, 17, 23)

	%nums:insert(1, 16, %perfect, %primes)		%nums:insert(2, 16, %perfect, %primes)
	%nums:print		%nums:print

	end		end
	</p>		</p>
Line 73:		Line 73:
	In the following example, a new object, an object variable and another <var>Arraylist</var> of objects are inserted into an <var>Arraylist</var>:		In the following example, a new object, an object variable and another <var>Arraylist</var> of objects are inserted into an <var>Arraylist</var>:
	<p class="code">b		<p class="code">b

	class coordinate		class coordinate
	public		public
Line 100:		Line 99:

	%points:print		%points:print

	end		end
	</p>		</p>

JAL: /* Inserting objects into an Arraylist */

2012-11-01T15:42:41Z

Inserting objects into an Arraylist

← Older revision		Revision as of 15:42, 1 November 2012
Line 70:		Line 70:
	</p>		</p>

	===Inserting objects into an Arraylist===		====Inserting objects into an Arraylist====
	In the following example, a new object, an object variable and another <var>Arraylist</var> of objects are inserted into an <var>Arraylist</var>:		In the following example, a new object, an object variable and another <var>Arraylist</var> of objects are inserted into an <var>Arraylist</var>:
	<p class="code">b		<p class="code">b

JAL: /* Inserting numbers into an Arraylist */

2012-11-01T15:42:32Z

Inserting numbers into an Arraylist

← Older revision		Revision as of 15:42, 1 November 2012
Line 38:		Line 38:
	For more examples of <var>Insert</var> calls, see [[Arraylist class\|"Arraylist class"]].		For more examples of <var>Insert</var> calls, see [[Arraylist class\|"Arraylist class"]].

	===Inserting numbers into an Arraylist===		====Inserting numbers into an Arraylist====
	In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is inserted into an <var>Arraylist</var>:		In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is inserted into an <var>Arraylist</var>:
	<p class="code">b		<p class="code">b

JAL2: /* Inserting objects into an Arraylist */

2012-07-20T20:14:45Z

Inserting objects into an Arraylist

← Older revision		Revision as of 20:14, 20 July 2012
Line 71:		Line 71:

	===Inserting objects into an Arraylist===		===Inserting objects into an Arraylist===
	In the following example, a new object, an object variable and another <var>Arraylist</var> of objects are inserted into an<var>Arraylist</var>:		In the following example, a new object, an object variable and another <var>Arraylist</var> of objects are inserted into an <var>Arraylist</var>:
	<p class="code">b		<p class="code">b

JAL2: /* Examples */

2012-07-20T20:14:30Z

Examples

← Older revision		Revision as of 20:14, 20 July 2012
Line 36:		Line 36:

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

	===Inserting numbers into an Arraylist===		===Inserting numbers into an Arraylist===
	In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is inserted into an <var>Arraylist</var>:		In the following example, a literal number, a numeric variable and another <var>Arraylist</var> of numbers is inserted into an <var>Arraylist</var>:

JAL2: /* Syntax terms */

2012-07-20T20:12:05Z

Syntax terms

← Older revision		Revision as of 20:12, 20 July 2012
Line 8:		Line 8:
	<tr><th>%count</th>		<tr><th>%count</th>
	<td>An, optional, numeric variable to return the number of items in the indicated <var>Arraylist</var> after the items have been inserted. </td></tr>		<td>An, optional, numeric variable to return the number of items in the indicated <var>Arraylist</var> after the items have been inserted. </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>number</th>		<tr><th>number</th>
	<td>A whole number, from 1 to the number of items in <var class="term">al</var> plus one, to identify an <var class="term">al</var> item <b><i>before</i></b> which the items in <var class="term">itemList</var> will be inserted.</td></tr>		<td>A whole number, from 1 to the number of items in <var class="term">al</var> plus one, to identify an <var class="term">al</var> item <b><i>before</i></b> which the items in <var class="term">itemList</var> will be inserted.</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, is inserted into 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~~ inserted into the method object <var>Arraylist</var>.		Each of these, from left to right, becomes an item or items inserted into 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 inserted into <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>

JAL2 at 21:02, 18 July 2011

2011-07-18T21:02:28Z

← Older revision		Revision as of 21:02, 18 July 2011
Line 1:		Line 1:
	{{Template:Arraylist:Insert subtitle}}		{{Template:Arraylist:Insert subtitle}}
	~~The <var>Insert</var>~~ callable function inserts one or more new items before the <var class="term">number</var> item in the <var>Arraylist</var>.		This [[Notation conventions for methods#Callable functions\|callable]] function inserts one or more new items before the <var class="term">number</var> item in the <var>Arraylist</var>.

	==Syntax==		==Syntax==

Alex: /* Adding objects to an Arraylist */

2011-03-14T02:53:18Z

Adding objects to an Arraylist

← Older revision		Revision as of 02:53, 14 March 2011
Line 62:		Line 62:
	</p>		</p>

	===~~Adding~~ objects to an Arraylist===		===Inserting objects into 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 are inserted into an<var>Arraylist</var>:
	<p class="code">b		<p class="code">b

Line 89:		Line 89:
	%locations = list(new(1, 1), new(2, 5), new(3, 11))		%locations = list(new(1, 1), new(2, 5), new(3, 11))

	%points:~~add~~(new(4, 3), %where, %locations)		%points:insert(2, new(4, 3), %where, %locations)

	%points:print		%points:print
Line 97:		Line 97:
	This outputs:		This outputs:
	<p class="output">1: coordinate: x=6, y=9		<p class="output">1: coordinate: x=6, y=9
	2: coordinate: x=-4, y=3		2: coordinate: x=4, y=3
	3: coordinate: x=4, y=3		3: coordinate: x=17, y=-3
	4: coordinate: x=17, y=-3		4: coordinate: x=1, y=1
	5: coordinate: x=1, y=1		5: coordinate: x=2, y=5
	6: coordinate: x=2, y=5		6: coordinate: x=3, y=11
	7: coordinate: x=3, y=11		7: coordinate: x=-4, y=3
	</p>		</p>

	==See also==		==See also==
	{{Template:Arraylist:Insert footer}}		{{Template:Arraylist:Insert footer}}