SubsetNew (Arraylist function) - Revision history

JAL2 at 20:23, 17 July 2012

2012-07-17T20:23:28Z

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

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%newList</th>		<tr><th>%newList</th>
	<td>An <var>Arraylist</var> variable of the same type as the method <var>Arraylist</var> (<var class="term">al</var>) to receive the items that are located by the search. If <var class="term">%newList</var> is not empty, its contents are discarded before it is populated by any items returned from <var>SubsetNew</var>.</td></tr>		<td>An <var>Arraylist</var> variable of the same type as the method <var>Arraylist</var> (<var class="term">al</var>) to receive the items that are located by the search. If <var class="term">%newList</var> is not empty, its contents are discarded before it is populated by any items returned from <var>SubsetNew</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>selectionCriterion</th>		<tr><th>selectionCriterion</th>
	<td>A <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.		<td>A <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.
Line 17:		Line 20:

	==Usage notes==		==Usage notes==
	<ul><li><var>SubsetNew</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6 and later.		<ul>
			<li><var>[[FindNextItem (Arraylist function)\|FindNextItem]]</var> without the <var>Start</var> argument is similar to <var>SubsetNew</var> except that it returns just the first matching item it encounters.
			<li><var>[[CountSubset (Arraylist function)\|CountSubset]]</var> returns a count of the subset of an <var>Arraylist</var> that matches a selection criterion.
			<li><var>SubsetNew</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6 and later.
	</ul>		</ul>

Line 53:		Line 59:

	==See also==		==See also==
	<ul><li><var>[[FindNextItem (Arraylist function)\|FindNextItem]]</var> without the <var class="term">Start</var> argument is similar to <var>SubsetNew</var> except that it returns just the first matching item it encounters.
	~~</ul>~~
	{{Template:Arraylist:SubsetNew footer}}		{{Template:Arraylist:SubsetNew footer}}

JAL2: /* Examples */

2011-08-22T21:11:07Z

Examples

← Older revision		Revision as of 21:11, 22 August 2011
Line 21:		Line 21:

	==Examples==		==Examples==
	~~<ol><li>~~The following request contains two <var>SubsetNew</var> calls, one with a simple selection criterion and one with a compound criterion:		The following request contains two <var>SubsetNew</var> calls, one with a simple selection criterion and one with a compound criterion:
	<p class="code">begin		<p class="code">begin
	%al is arraylist of float		%al is arraylist of float
Line 51:		Line 51:
	2: 77		2: 77
	</p>		</p>
	~~</ol>~~

	==See also==		==See also==

JALWiccan: 1 revision

2011-05-04T17:45:56Z

1 revision

← Older revision	Revision as of 17:45, 4 May 2011
(No difference)

Dme at 17:45, 4 May 2011

2011-05-04T17:45:54Z

← Older revision		Revision as of 17:45, 4 May 2011
Line 17:		Line 17:

	==Usage notes==		==Usage notes==
	<ul><li><var>SubsetNew</var> is available in <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6 and later.		<ul><li><var>SubsetNew</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6 and later.
	</ul>		</ul>

Dme at 17:50, 3 May 2011

2011-05-03T17:50:45Z

← Older revision		Revision as of 17:50, 3 May 2011
Line 12:		Line 12:
	<tr><th>selectionCriterion</th>		<tr><th>selectionCriterion</th>
	<td>A <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.		<td>A <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.
	<p>For example, <code>GT(this, -11)</code> is the criterion <code>this > -11</code>, where <~~code~~>this</~~code~~> is an identity function that simply returns the item's value. The items that satisfy this expression populate the <var>Arraylist</var> that <var>SubsetNew</var> returns.</p>		<p>For example, <code>GT(this, -11)</code> is the criterion <code>this > -11</code>, where <var>this</var> is an identity function value that simply returns the item's value. The items that satisfy this expression populate the <var>Arraylist</var> that <var>SubsetNew</var> returns.</p>
	<p>The function in the criterion is a method value (a method or class member name literal, or a method variable) for a method that operates on items of the type specified on the <var class="term">al</var> declaration and that returns a numeric or string value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].</p></td></tr>		<p>The function in the criterion is a method value (a method or class member name literal, or a method variable) for a method that operates on items of the type specified on the <var class="term">al</var> declaration and that returns a numeric or string value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].</p></td></tr>
	</table>		</table>

Goff: trivialities

2011-03-13T23:38:38Z

trivialities

← Older revision		Revision as of 23:38, 13 March 2011
Line 11:		Line 11:
	<td>An <var>Arraylist</var> object. </td></tr>		<td>An <var>Arraylist</var> object. </td></tr>
	<tr><th>selectionCriterion</th>		<tr><th>selectionCriterion</th>
	<td>A <var>SelectionCriterion</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.<p>For example, <code>GT(this, -11)</code> is the criterion <code>this > -11</code>, where <code>this</code> is an identity function that simply returns the item's value. The items that satisfy this expression populate the <var>Arraylist</var> that <var>SubsetNew</var> returns.</p><p>The function in the criterion is a method value (a method or class member name literal, or a method variable) for a method that operates on items of the type specified on the <var class="term">al</var> declaration and that returns a numeric or string value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].</p></td></tr>		<td>A <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.
			<p>For example, <code>GT(this, -11)</code> is the criterion <code>this > -11</code>, where <code>this</code> is an identity function that simply returns the item's value. The items that satisfy this expression populate the <var>Arraylist</var> that <var>SubsetNew</var> returns.</p>
			<p>The function in the criterion is a method value (a method or class member name literal, or a method variable) for a method that operates on items of the type specified on the <var class="term">al</var> declaration and that returns a numeric or string value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].</p></td></tr>
	</table>		</table>

Goff: see also

2011-03-11T05:48:17Z

Goff: very minor

2011-03-11T05:35:30Z

very minor

← Older revision		Revision as of 05:35, 11 March 2011
Line 1:		Line 1:
	{{Template:Arraylist:SubsetNew subtitle}}		{{Template:Arraylist:SubsetNew subtitle}}

	<var>SubsetNew</var> searches the entire <var>Arraylist</var> to find and return all items that match a specified criterion. The criterion is supplied by the <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object that is the required <var>SubsetNew</var> parameter. If no item satisfies the criterion, <var>SubsetNew</var> returns an empty <var>Arraylist</var>.		<var>SubsetNew</var> searches the entire <var>Arraylist</var> to find and return all items that match a specified criterion. The criterion is supplied by the <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object that is the required <var>SubsetNew</var> parameter. If no item satisfies the criterion, <var>SubsetNew</var> returns an empty <var>Arraylist</var>.

Line 19:		Line 18:
	<li><var>[[FindNextItem (Arraylist function)\|FindNextItem]]</var> without the <var class="term">Start</var> argument is similar to <var>SubsetNew</var> except that it returns just the first matching item		<li><var>[[FindNextItem (Arraylist function)\|FindNextItem]]</var> without the <var class="term">Start</var> argument is similar to <var>SubsetNew</var> except that it returns just the first matching item
	it encounters.		it encounters.
	<li><var>SubsetNew</var> is available in <var class="product">Sirius Mods</var> ~~version~~ 7.6 and later.		<li><var>SubsetNew</var> is available in <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6 and later.
	</ul>		</ul>

Line 26:		Line 25:
	<li>The following request contains two <var>SubsetNew</var> calls, one with a simple selection criterion and one with a compound criterion:		<li>The following request contains two <var>SubsetNew</var> calls, one with a simple selection criterion and one with a compound criterion:
	<p class="code">begin		<p class="code">begin
	%al is arraylist of float		%al is arraylist of float
	%alnew is arraylist of float		%alnew is arraylist of float
	%al = list(111, 29, 0, 93, 77, -345)		%al = list(111, 29, 0, 93, 77, -345)

	%sel1 is object selectioncriterion for float		%sel1 is object selectioncriterion for float
	%sel2 is object selectioncriterion for float		%sel2 is object selectioncriterion for float
	%sel1 = GT(this, 0)		%sel1 = GT(this, 0)
	%sel2 = AND(GE(this, 50), LT(this, 93))		%sel2 = AND(GE(this, 50), LT(this, 93))

	%alnew = %al:SubsetNew(%sel1)		%alnew = %al:SubsetNew(%sel1)
	Print 'The result of selection1 is:'		Print 'The result of selection1 is:'
	%alnew:print		%alnew:print
	%alnew = %al:SubsetNew(%sel2)		%alnew = %al:SubsetNew(%sel2)
	~~Print~~ 'The result of selection2 is:'		print 'The result of selection2 is:'
	%alnew:print		%alnew:print
	~~End~~		end
	</p>		</p>

JAL at 22:20, 2 March 2011

2011-03-02T22:20:39Z

← Older revision		Revision as of 22:20, 2 March 2011
Line 12:		Line 12:
	<td>An <var>Arraylist</var> object. </td></tr>		<td>An <var>Arraylist</var> object. </td></tr>
	<tr><th>selectionCriterion</th>		<tr><th>selectionCriterion</th>
	<td>A <var>SelectionCriterion</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.<p>For example, <code>GT(this, -11)</code> is the criterion <code>this > -11</code>, where <code>this</code> is an identity function that simply returns the item's value. The items that satisfy this expression populate the <var>Arraylist</var> that <var>SubsetNew</var> returns.</p><p>The function in the criterion is a method value (a method or class member name literal, or a method variable) for a method that operates on items of the type specified on the <var class="term">al</var> declaration and that returns a numeric or string value. This is described further in "[[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|Specifying a SelectionCriterion's parameters]]".</p></td></tr>		<td>A <var>SelectionCriterion</var> object, which is a relational expression that is applied to an <var class="term">al</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a numeric or string value.<p>For example, <code>GT(this, -11)</code> is the criterion <code>this > -11</code>, where <code>this</code> is an identity function that simply returns the item's value. The items that satisfy this expression populate the <var>Arraylist</var> that <var>SubsetNew</var> returns.</p><p>The function in the criterion is a method value (a method or class member name literal, or a method variable) for a method that operates on items of the type specified on the <var class="term">al</var> declaration and that returns a numeric or string value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].</p></td></tr>
	</table>		</table>

Wiccan: 1 revision

2011-02-07T23:00:08Z

1 revision

← Older revision	Revision as of 23:00, 7 February 2011
(No difference)

← Older revision		Revision as of 05:48, 11 March 2011
Line 15:		Line 15:

	==Usage notes==		==Usage notes==
	<ul>		<ul><li><var>SubsetNew</var> is available in <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6 and later.
	<li><var>[[FindNextItem (Arraylist function)\|FindNextItem]]</var> without the <var class="term">Start</var> argument is similar to <var>SubsetNew</var> except that it returns just the first matching item
	~~it encounters.~~
	<li><var>SubsetNew</var> is available in <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.6 and later.
	</ul>		</ul>

	==Examples==		==Examples==
	<ol>		<ol><li>The following request contains two <var>SubsetNew</var> calls, one with a simple selection criterion and one with a compound criterion:
	<li>The following request contains two <var>SubsetNew</var> calls, one with a simple selection criterion and one with a compound criterion:
	<p class="code">begin		<p class="code">begin
	%al is arraylist of float		%al is arraylist of float
Line 56:		Line 52:

	==See also==		==See also==
			<ul><li><var>[[FindNextItem (Arraylist function)\|FindNextItem]]</var> without the <var class="term">Start</var> argument is similar to <var>SubsetNew</var> except that it returns just the first matching item it encounters.
			</ul>
	{{Template:Arraylist:SubsetNew footer}}		{{Template:Arraylist:SubsetNew footer}}