SortNew (GenericNamedArraylist function) - Revision history

JAL at 20:06, 1 November 2012

2012-11-01T20:06:20Z

← Older revision		Revision as of 20:06, 1 November 2012
Line 9:		Line 9:
	==Syntax==		==Syntax==
	{{Template:GenericNamedArraylist:SortNew syntax}}		{{Template:GenericNamedArraylist:SortNew syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%al</th>		<tr><th>%al</th>
	<td>An <var>Arraylist</var> object to contain the sorted <var class="term">anyNal</var> items. </td></tr>		<td>An <var>Arraylist</var> object to contain the sorted <var class="term">anyNal</var> items. </td></tr>

	<tr><th>anyNal</th>		<tr><th>anyNal</th>
	<td>The input <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> object. </td></tr>		<td>The input <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> object. </td></tr>

	<tr><th>sortOrder</th>		<tr><th>sortOrder</th>
	<td>One or more <var>[[SortOrder ~~class\|SortOrder]]~~</var> objects, which consist of an ordering direction for the sort and a key to sort by, specified in the form: <code>order(key)</code>. The order is either <code>Ascending</code> or <code>Descending</code>, and the key is a function that is applied to each item in the <var class="term">anyNal</var> <var>arrayList</var>. For example: <p class="code">%alist = %namray:sortnew(descending(length))</p>		<td>One or more <var>SortOrder</var> objects, which consist of an ordering direction for the sort and a key to sort by, specified in the form: <code>order(key)</code>. The order is either <code>Ascending</code> or <code>Descending</code>, and the key is a function that is applied to each item in the <var class="term">anyNal</var> <var>arrayList</var>. For example: <p class="code">%alist = %namray:sortnew(descending(length))</p>
	The function is a method value (a method or class member name literal, or a method variable) for a method that operates on objects of the type specified on the <var class="term">anyNal</var> declaration and that returns a numeric or string value. This is described further in [[SortOrder class#Specifying a SortOrder's sort key method\|"Specifying a SortOrder's sort key method"]].</td></tr>		The function is a method value (a method or class member name literal, or a method variable) for a method that operates on objects of the type specified on the <var class="term">anyNal</var> declaration and that returns a numeric or string value. This is described further in [[SortOrder class#Specifying a SortOrder's sort key method\|"Specifying a SortOrder's sort key method"]].</td></tr>
	</table>		</table>

JAL2: /* Usage notes */

2012-08-13T19:38:19Z

Usage notes

← Older revision		Revision as of 19:38, 13 August 2012
Line 22:		Line 22:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the function applied by <var>SortNew</var> returns <var>String</var> or <var>Unicode</var> values, <var>SortNew</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items.		<li>If the function applied by <var>SortNew</var> returns <var>String</var> or <var>Unicode</var> values, <var>SortNew</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. If the function returns a numeric type, numeric comparisons are used.

	<li>If two or more <var class="term">anyNal</var> items have equal values after all sort criteria are applied, <var>SortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.		<li>If two or more <var class="term">anyNal</var> items have equal values after all sort criteria are applied, <var>SortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.

JAL2: /* Usage notes */

2012-08-09T23:10:09Z

Usage notes

← Older revision		Revision as of 23:10, 9 August 2012
Line 22:		Line 22:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the function applied by <var>SortNew</var> returns ~~string~~ values, <var>SortNew</var> uses the ~~decimal-equivalent value~~ of ~~the character bytes~~ to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. ~~Lowercase letters are first ranked alphabetically, then uppercase letters, also ranked alphabetically, followed by the numbers; ie: <code>'a'..'z','A'..'Z',0..9</code>.~~		<li>If the function applied by <var>SortNew</var> returns <var>String</var> or <var>Unicode</var> values, <var>SortNew</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items.

	<li>If two or more <var class="term">anyNal</var> items have equal values after all sort criteria are applied, <var>SortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.		<li>If two or more <var class="term">anyNal</var> items have equal values after all sort criteria are applied, <var>SortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.

	<li>The function in the parameter for <var>SortNew</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.		<li>The function in the parameter for <var>SortNew</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.

	<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">anyNal</var>:sortNew(ascending(this))</code> can be specified simply as <code><var class="term">anyNal</var>:sortNew</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].		<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">anyNal</var>:sortNew(ascending(this))</code> can be specified simply as <code><var class="term">anyNal</var>:sortNew</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].

	<li><var>SortNew</var> is available in <var class="product">Sirius Mods</var> Version 7.3 and later.		<li><var>SortNew</var> is available in <var class="product">Sirius Mods</var> Version 7.3 and later.
	</ul>		</ul>

Dme at 21:54, 7 August 2012

2012-08-07T21:54:13Z

← Older revision		Revision as of 21:54, 7 August 2012
Line 5:		Line 5:
	In the <var>SortNew</var> parameter, you identify the sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item.		In the <var>SortNew</var> parameter, you identify the sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item.
	This function must		This function must
	operate on that item type and return an <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String~~</var>, <var>Longstring~~</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>Arraylist</var>.		operate on that item type and return an <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>Arraylist</var>.

	==Syntax==		==Syntax==
Line 22:		Line 22:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the function applied by <var>~~sortNew~~</var> returns string values, <var>~~sortNew~~</var> uses the decimal-equivalent value of the character bytes to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. Lowercase letters are first ranked alphabetically, then uppercase letters, also ranked alphabetically, followed by the numbers; ie: <code>'a'..'z','A'..'Z',0..9</code>.		<li>If the function applied by <var>SortNew</var> returns string values, <var>SortNew</var> uses the decimal-equivalent value of the character bytes to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. Lowercase letters are first ranked alphabetically, then uppercase letters, also ranked alphabetically, followed by the numbers; ie: <code>'a'..'z','A'..'Z',0..9</code>.
	<li>If two or more <var class="term">al</var> items have equal values after all sort criteria are applied, <var>~~sortNew~~</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.		<li>If two or more <var class="term">anyNal</var> items have equal values after all sort criteria are applied, <var>SortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.
	<li>The function in the parameter for <var>SortNew</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.		<li>The function in the parameter for <var>SortNew</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.
	<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">al</var>:~~sortnew~~(ascending(this))</code> can be specified simply as <code><var class="term">al</var>:~~sortnew~~</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].		<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">anyNal</var>:sortNew(ascending(this))</code> can be specified simply as <code><var class="term">anyNal</var>:sortNew</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].
	<li><var>SortNew</var> is available in <var class="product">Sirius Mods</var> Version 7.3 and later.		<li><var>SortNew</var> is available in <var class="product">Sirius Mods</var> Version 7.3 and later.
	</ul>		</ul>
Line 101:		Line 101:
	Michael Palin (born: 19430505)		Michael Palin (born: 19430505)
	</p>		</p>

			<li>This fragment is a simple <var>SortNew</var> example; the string items are sorted by their values:
			<p class="code">%nal is namedArraylist of string len 30
			%nal = new
			%nal('Akron') = 'Rubber City'
			%nal('Atlanta') = 'The Athens of the South'
			%nal('Philadelphia') = 'City of Brotherly love'
			%al is arraylist of string len 30
			%al = %nal:sortNew(ascending)
			%al:print
			</p>
			The result is:
			<p class="output">1: City of Brotherly love
			2: Rubber City
			3: The Athens of the South
			</p>

	<li>For additional sorting examples, see [[Collections#Finding collection maxima and minima, and sorting\|"Finding collection maxima and minima, and sorting"]].</ol>		<li>For additional sorting examples, see [[Collections#Finding collection maxima and minima, and sorting\|"Finding collection maxima and minima, and sorting"]].</ol>

	==See also==		==See also==
	{{Template:GenericNamedArraylist:SortNew footer}}		{{Template:GenericNamedArraylist:SortNew footer}}

JAL2: /* Usage notes */

2012-03-19T19:24:43Z

Usage notes

← Older revision		Revision as of 19:24, 19 March 2012
Line 22:		Line 22:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the function applied by <var>sortNew</var> returns string values, <var>sortNew</var> uses the decimal-equivalent value of the character bytes to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. Lowercase letters are first ranked alphabetically, then ~~upper case~~ letters, also ranked alphabetically, followed by the numbers; ie: <code>'a'..'z','A'..'Z',0..9</code>.		<li>If the function applied by <var>sortNew</var> returns string values, <var>sortNew</var> uses the decimal-equivalent value of the character bytes to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. Lowercase letters are first ranked alphabetically, then uppercase letters, also ranked alphabetically, followed by the numbers; ie: <code>'a'..'z','A'..'Z',0..9</code>.
	<li>If two or more <var class="term">al</var> items have equal values after all sort criteria are applied, <var>sortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.		<li>If two or more <var class="term">al</var> items have equal values after all sort criteria are applied, <var>sortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.
	<li>The function in the parameter for <var>SortNew</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.		<li>The function in the parameter for <var>SortNew</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.
	<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">al</var>:sortnew(ascending(this))</code> can be specified simply as <code><var class="term">al</var>:sortnew</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].		<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">al</var>:sortnew(ascending(this))</code> can be specified simply as <code><var class="term">al</var>:sortnew</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].
	<li>SortNew is available in <var class="product">~~[[Sirius Mods\|~~Sirius Mods]]</var> Version 7.3 and later.		<li><var>SortNew</var> is available in <var class="product">Sirius Mods</var> Version 7.3 and later.
	</ul>		</ul>

JALWiccan: 1 revision

2012-03-19T18:44:15Z

1 revision

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

JAL2 at 18:44, 19 March 2012

2012-03-19T18:44:14Z

← Older revision		Revision as of 18:44, 19 March 2012
Line 24:		Line 24:
	<li>If the function applied by <var>sortNew</var> returns string values, <var>sortNew</var> uses the decimal-equivalent value of the character bytes to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. Lowercase letters are first ranked alphabetically, then upper case letters, also ranked alphabetically, followed by the numbers; ie: <code>'a'..'z','A'..'Z',0..9</code>.		<li>If the function applied by <var>sortNew</var> returns string values, <var>sortNew</var> uses the decimal-equivalent value of the character bytes to determine the ascending or descending alphabetic order of the associated <var class="term">al</var> items. Lowercase letters are first ranked alphabetically, then upper case letters, also ranked alphabetically, followed by the numbers; ie: <code>'a'..'z','A'..'Z',0..9</code>.
	<li>If two or more <var class="term">al</var> items have equal values after all sort criteria are applied, <var>sortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.		<li>If two or more <var class="term">al</var> items have equal values after all sort criteria are applied, <var>sortNew</var> returns them in the same order in which they appear in the input <var class="term">anyNal</var>.
	<li>The function in the parameter for <var>SortNew</var> is a method value, not a User Language expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.		<li>The function in the parameter for <var>SortNew</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that, itself, also has an argument (say, <code>Char(13)</code>) as the <var>SortNew</var> parameter.
	<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">al</var>:sortnew(ascending(this))</code> can be specified simply as <code><var class="term">al</var>:sortnew</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].		<li>As of <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.6, the default <var>sortCriteria</var> argument is the <var>SortOrder</var> <code>Ascending(This)</code>, where <code>This</code> is the identity function described further in [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]]. Therefore, <code><var class="term">al</var>:sortnew(ascending(this))</code> can be specified simply as <code><var class="term">al</var>:sortnew</code>. See the [[SortNew (Arraylist function)#Examples\|SortNew example]].
	<li>SortNew is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.		<li>SortNew is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.

JAL2 at 22:25, 30 November 2011

2011-11-30T22:25:54Z

← Older revision		Revision as of 22:25, 30 November 2011
Line 1:		Line 1:
	{{Template:GenericNamedArraylist:SortNew subtitle}}		{{Template:GenericNamedArraylist:SortNew subtitle}}

	<var>SortNew</var> sorts the method object <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> and returns the sorted result in a new <var>[[Arraylist class\|Arraylist]]</var>. The sort is based on one or more sort criteria which ~~consist~~ of a sorting direction (ascending or descending) paired with a sort key (a function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item). ~~Each~~ sort ~~criterion pair is~~ a <var>[[SortOrder class\|SortOrder]]</var> ~~object, and multiple pairs are a <var>SortOrder</var> collection~~.		<var>SortNew</var> sorts the method object <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> and returns the sorted result in a new <var>[[Arraylist class\|Arraylist]]</var>. The sort is based on one or more sort criteria, each of which consists of a sorting direction (ascending or descending) paired with a sort key (a function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item). The sort criteria pairs are passed to <var>SortNew</var> as a <var>[[SortOrder class\|SortOrder]]</var> argument.

	In the <var>SortNew</var> parameter, you identify the sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item.		In the <var>SortNew</var> parameter, you identify the sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item.
	This function must		This function must
	operate on that item type and return ~~a <var class="product">User Language</var>~~ <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>Arraylist</var>.		operate on that item type and return an <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>Arraylist</var>.

	==Syntax==		==Syntax==

JAL2 at 16:33, 28 July 2011

2011-07-28T16:33:47Z

← Older revision		Revision as of 16:33, 28 July 2011
Line 1:		Line 1:
	{{Template:GenericNamedArraylist:SortNew subtitle}}		{{Template:GenericNamedArraylist:SortNew subtitle}}

	<var>SortNew</var> sorts the method object <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var>~~, returning a new object (of the same type as the input object) that holds~~ the sorted result. The sort is based on one or more ~~[[SortOrder_class\|~~sort criteria]] which consist of a sorting direction (ascending or descending) paired with a sort key (a function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item). Each sort criterion pair is a <var>[[SortOrder class\|SortOrder]]</var> object, and multiple pairs are a <var>SortOrder</var> collection.		<var>SortNew</var> sorts the method object <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> and returns the sorted result in a new <var>[[Arraylist class\|Arraylist]]</var>. The sort is based on one or more sort criteria which consist of a sorting direction (ascending or descending) paired with a sort key (a function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item). Each sort criterion pair is a <var>[[SortOrder class\|SortOrder]]</var> object, and multiple pairs are a <var>SortOrder</var> collection.

	~~<p>~~In the <var>SortNew</var> parameter, you identify the sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item.		In the <var>SortNew</var> parameter, you identify the sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item.
	This function must		This function must
	operate on that item type and return a <var class="product">User Language</var> <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>~~arraylist~~</var>.~~</p>~~		operate on that item type and return a <var class="product">User Language</var> <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>Arraylist</var>.

	==Syntax==		==Syntax==
Line 12:		Line 12:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%al</th>		<tr><th>%al</th>
	<td>~~The newly created~~ <var>~~FloatNamedArraylist~~</var>~~, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var>, that will~~ contain the sorted <var class="term">anyNal</var> items. </td></tr>		<td>An <var>Arraylist</var> object to contain the sorted <var class="term">anyNal</var> items. </td></tr>
	<tr><th>anyNal</th>		<tr><th>anyNal</th>
	<td>The input <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> object. </td></tr>		<td>The input <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> object. </td></tr>

JAL2 at 15:52, 28 July 2011

2011-07-28T15:52:39Z

← Older revision		Revision as of 15:52, 28 July 2011
Line 3:		Line 3:
	<var>SortNew</var> sorts the method object <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var>, returning a new object (of the same type as the input object) that holds the sorted result. The sort is based on one or more [[SortOrder_class\|sort criteria]] which consist of a sorting direction (ascending or descending) paired with a sort key (a function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item). Each sort criterion pair is a <var>[[SortOrder class\|SortOrder]]</var> object, and multiple pairs are a <var>SortOrder</var> collection.		<var>SortNew</var> sorts the method object <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var>, returning a new object (of the same type as the input object) that holds the sorted result. The sort is based on one or more [[SortOrder_class\|sort criteria]] which consist of a sorting direction (ascending or descending) paired with a sort key (a function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item). Each sort criterion pair is a <var>[[SortOrder class\|SortOrder]]</var> object, and multiple pairs are a <var>SortOrder</var> collection.

	<p>~~The~~ sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item~~, which you identify in the <var>SortNew</var> parameter,~~ must		<p>In the <var>SortNew</var> parameter, you identify the sort key function that gets applied to each <var>FloatNamedArraylist</var>, <var>NamedArraylist</var>, or <var>UnicodeNamedArraylist</var> item.
	operate on ~~the~~ item type and return a <var class="product">User Language</var> <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>arraylist</var>.</p>		This function must
			operate on that item type and return a <var class="product">User Language</var> <var>[[Intrinsic classes\|intrinsic]]</var> datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value. The values returned by the function are sorted into ascending or descending order to determine the position of their associated item in the result <var>arraylist</var>.</p>

	==Syntax==		==Syntax==