SubsetNew (UnicodeNamedArraylist function) - Revision history

Dme: /* See also */

2012-08-03T16:39:00Z

JAL2 at 19:54, 19 March 2012

2012-03-19T19:54:26Z

← Older revision		Revision as of 19:54, 19 March 2012
Line 14:		Line 14:
	<p>For example, <code>LT(this, 91)</code> is the criterion <code>this < 91</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>UnicodeNamedArraylist</var> that <var>SubsetNew</var> returns.		<p>For example, <code>LT(this, 91)</code> is the criterion <code>this < 91</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>UnicodeNamedArraylist</var> that <var>SubsetNew</var> returns.
	</p>		</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">uniNal</var> declaration and that returns an intrinsic value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].		<p>The function in the criterion is a method value (a method or class member name literal, or a [[Method variables\|method variable]]) for a method that operates on items of the type specified on the <var class="term">uniNal</var> declaration and that returns an intrinsic value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].
	</p></td></tr>		</p></td></tr>
	</table>		</table>

	==Examples==		==Examples==
	~~<ol><li>~~In the following request, a <var>SubsetNew</var> call uses a selection criterion that first applies the intrinsic [[Length (String function)\|Length]] function to the collection items:		In the following request, a <var>SubsetNew</var> call uses a selection criterion that first applies the intrinsic [[Length (String function)\|Length]] function to the collection items:
	<p class="code">begin		<p class="code">begin
	%k is unicodeNamedArraylist of longstring		%k is unicodeNamedArraylist of longstring
Line 44:		Line 44:
	2: &sect.Jun: Ursa Minor		2: &sect.Jun: Ursa Minor
	3: &sect.Nov: Andromeda		3: &sect.Nov: Andromeda
	</p~~></ol~~>		</p>

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

JALWiccan: 1 revision

2012-03-19T18:44:17Z

1 revision

← Older revision	Revision as of 18:44, 19 March 2012
(No difference)

Goff: match syntax table to syntax template, tags and edits

2012-03-19T18:44:16Z

match syntax table to syntax template, tags and edits

← Older revision		Revision as of 18:44, 19 March 2012
Line 11:		Line 11:
	<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>		<td>A <var>UnicodeNamedArraylist</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 a <var class="term">uniNal</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a User Language intrinsic type (numeric, string, or Unicode) value.		<td>A <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object, which is a relational expression that is applied to a <var class="term">uniNal</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a <var class="product">User Language</var> intrinsic type (numeric, string, or Unicode) value.
	<p>For example, <code>LT(this, 91)</code> is the criterion <code>this < 91</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>UnicodeNamedArraylist</var> that <var>SubsetNew</var> returns.		<p>For example, <code>LT(this, 91)</code> is the criterion <code>this < 91</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>UnicodeNamedArraylist</var> that <var>SubsetNew</var> returns.
	</p>		</p>

Goff: match syntax table to syntax template, tags and edits

2011-03-11T06:24:32Z

match syntax table to syntax template, tags and edits

← Older revision		Revision as of 06:24, 11 March 2011
Line 1:		Line 1:
	{{Template:UnicodeNamedArraylist:SubsetNew subtitle}}		{{Template:UnicodeNamedArraylist:SubsetNew subtitle}}
			<var>SubsetNew</var> searches the entire <var>UnicodeNamedArraylist</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>UnicodeNamedArraylist</var>.

	~~This function searches the entire UnicodeNamedArraylist to find and return~~
	~~all items that match a specified criterion.~~
	~~The criterion is supplied by the [[SelectionCriterion class\|SelectionCriterion]] object~~
	~~that is the required SubsetNew parameter.~~
	~~If no item satisfies the criterion, SubsetNew returns an empty UnicodeNamedArraylist.~~
	==Syntax==		==Syntax==
	{{Template:UnicodeNamedArraylist:SubsetNew syntax}}		{{Template:UnicodeNamedArraylist:SubsetNew syntax}}
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%~~unamraylNew~~</th>		<tr><th>%outUniNal</th>
	<td>A UnicodeNamedArraylist variable of the same type as the method UnicodeNamedArraylist (~~''%unamrayl''~~) to contain the items that are located by the search. If ~~''%unamraylNew''~~ is not empty, its contents are discarded before it is populated by the ~~return~~ items from SubsetNew. </td></tr>		<td>A <var>UnicodeNamedArraylist</var> variable of the same type as the method <var>UnicodeNamedArraylist</var> (<var class="term">uniNal</var>) to contain the items that are located by the search. If <var class="term">outUniNal</var> is not empty, its contents are discarded before it is populated by the items returned from <var>SubsetNew</var>. </td></tr>
	<tr><th>~~%unamrayl~~</th>		<tr><th>uniNal</th>
	<td>A UnicodeNamedArraylist object. </td></tr>		<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>
	<tr><th>~~criterion~~</th>		<tr><th>selectionCriterion</th>
	<td>A SelectionCriterion object, which is a relational expression that is applied to a ~~''%unamrayl''~~ item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a User Language intrinsic type (numeric, string, or Unicode) value.		<td>A <var>[[SelectionCriterion class\|SelectionCriterion]]</var> object, which is a relational expression that is applied to a <var class="term">uniNal</var> item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a User Language intrinsic type (numeric, string, or Unicode) value.
			<p>For example, <code>LT(this, 91)</code> is the criterion <code>this < 91</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>UnicodeNamedArraylist</var> that <var>SubsetNew</var> returns.
	For example, <tt>LT(this, 91)</tt> is the criterion <tt>this<~~/tt> <tt><</tt> <tt>~~91</tt>, where <tt>this</tt> is an identity function that simply returns the item's value. The items that satisfy this expression populate the UnicodeNamedArraylist that SubsetNew returns.		</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 ~~''%unamrayl''~~ declaration and that returns an intrinsic value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].</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">uniNal</var> declaration and that returns an intrinsic value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].
			</p></td></tr>
			</table>

	~~</table>~~
	~~==Usage notes==~~
	~~<ul>~~
	~~<li>[[FindNextItem (UnicodeNamedArraylist function)\|FindNextItem]]~~
	~~is similar to SubsetNew except that it returns just the first matching item~~
	~~it encounters.~~
	~~</ul>~~
	==Examples==		==Examples==
			<ol><li>In the following request, a <var>SubsetNew</var> call uses a selection criterion that first applies the intrinsic [[Length (String function)\|Length]] function to the collection items:
			<p class="code">begin
			%k is unicodeNamedArraylist of longstring
			%kk is unicodeNamedArraylist of longstring
			%k = new
			%k('§Jan':u) = 'Orion'
			%k('§Apr':u) = 'Leo'
			%k('§Mar':u) = 'Cancer'
			%k('§Jun':u) = 'Ursa Minor'
			%k('§Nov':u) = 'Andromeda'
			%k('§Dec':u) = 'Aries'
			%k('§Feb':u) = 'Canis Major'

	~~In the following request, a SubsetNew call uses a selection criterion~~		%sel is object selectionCriterion for longstring
	~~that first applies the intrinsic [[Length (String function)\|Length]] function~~		%n is float
	~~to the collection items:~~		%sel = GE(length, 9)
	~~<p class="code">Begin~~

	~~%k is unicodeNamedArraylist of longstring~~
	~~%kk is unicodeNamedArraylist of longstring~~
	~~%k = new~~
	~~%k('§Jan':u) = 'Orion'~~
	~~%k('§Apr':u) = 'Leo'~~
	~~%k('§Mar':u) = 'Cancer'~~
	~~%k('§Jun':u) = 'Ursa Minor'~~
	~~%k('§Nov':u) = 'Andromeda'~~
	~~%k('§Dec':u) = 'Aries'~~
	~~%k('§Feb':u) = 'Canis Major'~~

	%sel is object selectionCriterion for longstring
	%n is float
	%sel = GE(length, 9)

	~~%kk = %k:subsetNew(%sel)~~
	~~%kk:print~~

	~~End~~		%kk = %k:subsetNew(%sel)
			%kk:print
			end
	</p>		</p>

	The result is:		The result is:
	<p class="output">1: &sect.Feb: Canis Major		<p class="output">1: &sect.Feb: Canis Major
	2: &sect.Jun: Ursa Minor		2: &sect.Jun: Ursa Minor
	3: &sect.Nov: Andromeda		3: &sect.Nov: Andromeda
	</p>		</p></ol>

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

JAL at 23:16, 2 March 2011

2011-03-02T23:16:47Z

← Older revision		Revision as of 23:16, 2 March 2011
Line 18:		Line 18:

	For example, <tt>LT(this, 91)</tt> is the criterion <tt>this</tt> <tt><</tt> <tt>91</tt>, where <tt>this</tt> is an identity function that simply returns the item's value. The items that satisfy this expression populate the UnicodeNamedArraylist that SubsetNew returns.		For example, <tt>LT(this, 91)</tt> is the criterion <tt>this</tt> <tt><</tt> <tt>91</tt>, where <tt>this</tt> is an identity function that simply returns the item's value. The items that satisfy this expression populate the UnicodeNamedArraylist that SubsetNew returns.
	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 ''%unamrayl'' declaration and that returns an intrinsic value. This is described further in "[[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|Specifying a SelectionCriterion's parameters]]".</td></tr>		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 ''%unamrayl'' declaration and that returns an intrinsic value. This is described further in [[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|"Specifying a SelectionCriterion's parameters"]].</td></tr>

	</table>		</table>

Wiccan: 1 revision

2011-02-08T18:23:45Z

1 revision

← Older revision	Revision as of 18:23, 8 February 2011
(No difference)

Wiccan: 1 revision

2011-02-08T18:23:44Z

1 revision

← Older revision		Revision as of 18:23, 8 February 2011
Line 16:		Line 16:
	<tr><th>criterion</th>		<tr><th>criterion</th>
	<td>A SelectionCriterion object, which is a relational expression that is applied to a ''%unamrayl'' item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a User Language intrinsic type (numeric, string, or Unicode) value.		<td>A SelectionCriterion object, which is a relational expression that is applied to a ''%unamrayl'' item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a User Language intrinsic type (numeric, string, or Unicode) value.
	~~<p class="code">~~For example, <tt>LT(this, 91)</tt> is the criterion <tt>this</tt> <tt><</tt> <tt>91</tt>, where <tt>this</tt> is an identity function that simply returns the item's value. The items that satisfy this expression populate the UnicodeNamedArraylist that SubsetNew returns.
			For example, <tt>LT(this, 91)</tt> is the criterion <tt>this</tt> <tt><</tt> <tt>91</tt>, where <tt>this</tt> is an identity function that simply returns the item's value. The items that satisfy this expression populate the UnicodeNamedArraylist that SubsetNew returns.
	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 ''%unamrayl'' declaration and that returns an intrinsic value. This is described further in "[[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|Specifying a SelectionCriterion's parameters]]".</td></tr>		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 ''%unamrayl'' declaration and that returns an intrinsic value. This is described further in "[[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|Specifying a SelectionCriterion's parameters]]".</td></tr>
	~~</p>~~
	</table>		</table>
	==Usage notes==		==Usage notes==

Wiccan: 1 revision

2011-02-06T22:34:49Z

1 revision

← Older revision	Revision as of 22:34, 6 February 2011
(No difference)

Wiccan: 1 revision

2011-02-06T22:34:48Z

1 revision

← Older revision		Revision as of 22:34, 6 February 2011
Line 16:		Line 16:
	<tr><th>criterion</th>		<tr><th>criterion</th>
	<td>A SelectionCriterion object, which is a relational expression that is applied to a ''%unamrayl'' item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a User Language intrinsic type (numeric, string, or Unicode) value.		<td>A SelectionCriterion object, which is a relational expression that is applied to a ''%unamrayl'' item value to determine whether the value satisfies the expression. The expression consists of a function, an operator, and a User Language intrinsic type (numeric, string, or Unicode) value.
	For example, <tt>LT(this, 91)</tt> is the criterion <tt>this</tt> <tt><</tt> <tt>91</tt>, where <tt>this</tt> is an identity function that simply returns the item's value. The items that satisfy this expression populate the UnicodeNamedArraylist that SubsetNew returns.		<p class="code">For example, <tt>LT(this, 91)</tt> is the criterion <tt>this</tt> <tt><</tt> <tt>91</tt>, where <tt>this</tt> is an identity function that simply returns the item's value. The items that satisfy this expression populate the UnicodeNamedArraylist that SubsetNew returns.
	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 ''%unamrayl'' declaration and that returns an intrinsic value. This is described further in "[[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|Specifying a SelectionCriterion's parameters]]".</td></tr>		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 ''%unamrayl'' declaration and that returns an intrinsic value. This is described further in "[[SelectionCriterion class#Specifying a SelectionCriterion's parameters\|Specifying a SelectionCriterion's parameters]]".</td></tr>
			</p>
	</table>		</table>
	==Usage notes==		==Usage notes==

← Older revision		Revision as of 16:39, 3 August 2012
Line 49:		Line 49:
	<ul>		<ul>
	<li><var>[[FindNextItem (UnicodeNamedArraylist function)\|FindNextItem]]</var> is similar to <var>SubsetNew</var> except that it returns just the first matching item it encounters.		<li><var>[[FindNextItem (UnicodeNamedArraylist function)\|FindNextItem]]</var> is similar to <var>SubsetNew</var> except that it returns just the first matching item it encounters.
			<li>The <var>NamedArraylist</var> <var>[[SubsetNew (NamedArraylist function)\|SubsetNew]]</var> and <var>FloatNamedArraylist</var> <var>[[SubsetNew (FloatNamedArraylist function)\|SubsetNew]]</var> functions also perform the subsetting function — for their respective classes. The examples on those pages may provide for possible additional approaches for <var>SubsetNew</var>.
	</ul>		</ul>
	{{Template:UnicodeNamedArraylist:SubsetNew footer}}		{{Template:UnicodeNamedArraylist:SubsetNew footer}}