Maximum (Arraylist function) - Revision history

JAL: /* Examples */

2012-11-01T16:12:08Z

Examples

← Older revision		Revision as of 16:12, 1 November 2012
Line 30:		Line 30:

	==Examples==		==Examples==
	===Maximum and Minimum using Count function===
			====Maximum and Minimum using Count function====
	In the following example, the <var>Maximum</var> and <var>Minimum</var> functions first apply the <var>Stringlist</var> <var>[[Count (Stringlist function)\|Count]]</var> function, then return the position of the <var>Arraylist</var> item <var>Stringlist</var> that has the most items and the one that has the fewest. The <var>Stringlist</var> <var>[[List (Stringlist function)\|List]]</var> function simplifies the construction of the lists.		In the following example, the <var>Maximum</var> and <var>Minimum</var> functions first apply the <var>Stringlist</var> <var>[[Count (Stringlist function)\|Count]]</var> function, then return the position of the <var>Arraylist</var> item <var>Stringlist</var> that has the most items and the one that has the fewest. The <var>Stringlist</var> <var>[[List (Stringlist function)\|List]]</var> function simplifies the construction of the lists.
	<p class="code">begin		<p class="code">begin
Line 54:		Line 55:
	</p>		</p>

	===Maximum and Minimum with local method===		====Maximum and Minimum with local method====
	The local method used with <var>Maximum</var> in the following request applies <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>, which (because it requires its own argument) the syntax of <var>Maximum</var> does not allow as a parameter.		The local method used with <var>Maximum</var> in the following request applies <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>, which (because it requires its own argument) the syntax of <var>Maximum</var> does not allow as a parameter.
	<p class="code">begin		<p class="code">begin

JAL: /* Usage notes */

2012-11-01T16:11:16Z

Usage notes

← Older revision		Revision as of 16:11, 1 November 2012
Line 19:		Line 19:

	==Usage notes==		==Usage notes==
	<ul><li>If the function applied by <var>Maximum</var> returns string values, <var>Maximum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the greatest value. Lowercase letters are first ranked alphabetically; then uppercase letters, also ranked alphabetically; finally followed by the numbers; that is: <code>'a'..'z','A'..'Z',0..9</code>.		<ul>
			<li>If the function applied by <var>Maximum</var> returns string values, <var>Maximum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the greatest value. Lowercase letters are first ranked alphabetically; then uppercase letters, also ranked alphabetically; finally followed by the numbers; that is: <code>'a'..'z','A'..'Z',0..9</code>.

	<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.		<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.
	<li>The parameter for <var>Maximum</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that itself has an argument (say, <~~var~~>[[ToIntegerPower ~~and ToPower~~ (~~Float functions~~)~~\|ToIntegerPower]]~~</~~var~~>~~(2)~~) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.
			<li>The parameter for <var>Maximum</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that itself has an argument (say, <code>ToIntegerPower(2)</code>) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.

	<li><var>Maximum</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.		<li><var>Maximum</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.
	</ul>		</ul>

JAL2 at 16:42, 27 July 2012

2012-07-27T16:42:11Z

← Older revision		Revision as of 16:42, 27 July 2012
Line 1:		Line 1:
	{{Template:Arraylist:Maximum subtitle}}		{{Template:Arraylist:Maximum subtitle}}
	<var>Maximum</var> returns the number of the <var>Arraylist</var> item that has the maximum numeric value after the application of a specified function to each item. The function that gets applied to each <var>Arraylist</var> item, which you identify using the <var class="term">~~method~~</var> argument, must be a method that operates on the item type and returns a <var class="product">User Language</var> [[Intrinsic classes\|intrinsic]] datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value.		<var>Maximum</var> returns the number of the <var>Arraylist</var> item that has the maximum numeric value after the application of a specified function to each item. The function that gets applied to each <var>Arraylist</var> item, which you identify using the <var class="term">itemFunction</var> argument, must be a method that operates on the item type and returns a <var class="product">User Language</var> [[Intrinsic classes\|intrinsic]] datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value.

	==Syntax==		==Syntax==
	{{Template:Arraylist:Maximum syntax}}		{{Template:Arraylist:Maximum syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
Line 12:		Line 13:
	<td>An <var>Arraylist</var> object.</td></tr>		<td>An <var>Arraylist</var> object.</td></tr>

	<tr><th>~~method~~</th>		<tr><th>itemFunction</th>
	<td>A ~~<var class="term">~~method~~</var>~~ value (a method name literal, a method variable, or even a method that returns a method value) 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.		<td>A method value (a method name literal, a method variable, or even a method that returns a method value) 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.
	<p>As of <var class="product">Sirius Mods</var> Version 7.6, the special identity function, <var>This</var> is the default <var class="term">~~method~~</var> value for the <var>Maximum</var> and <var>Minimum</var> methods. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]] for more information.</p></td></tr>		<p>As of <var class="product">Sirius Mods</var> Version 7.6, the special identity function, <var>This</var> is the default <var class="term">itemFunction</var> value for the <var>Maximum</var> and <var>Minimum</var> methods. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]] for more information.</p></td></tr>
	</table>		</table>

JAL2: /* Syntax terms */

2012-07-17T21:15:26Z

Syntax terms

← Older revision		Revision as of 21:15, 17 July 2012
Line 8:		Line 8:
	<tr><th>%number</th>		<tr><th>%number</th>
	<td>A numeric variable to return the item number of the item in the indicated <var>Arraylist</var> that has the maximum value after the argument function is applied.</td></tr>		<td>A numeric variable to return the item number of the item in the indicated <var>Arraylist</var> that has the maximum value after the argument function is applied.</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>method</th>		<tr><th>method</th>
	<td>A <var class="term">method</var> value (a method name literal, a method variable, or even a method that returns a method value) 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.		<td>A <var class="term">method</var> value (a method name literal, a method variable, or even a method that returns a method value) 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.

JAL2: /* Maximum and Minimum with local method */

2012-03-19T18:45:54Z

Maximum and Minimum with local method

← Older revision		Revision as of 18:45, 19 March 2012
Line 67:		Line 67:
	</p>		</p>

	Although applying the local method above to item 2 and item 4 produces the same value, <var>Maximum</var> returns the item that is closer to the beginning of the ~~arraylist~~.		Although applying the local method above to item 2 and item 4 produces the same value, <var>Maximum</var> returns the item that is closer to the beginning of the <var>Arraylist</var>.

	==See also==		==See also==
	<ul><li><var>[[Minimum (Arraylist function)\|Minimum]]</var> is the opposite of the <var>Maximum</var> function.</ul>		<ul><li><var>[[Minimum (Arraylist function)\|Minimum]]</var> is the opposite of the <var>Maximum</var> function.</ul>
	{{Template:Arraylist:Maximum footer}}		{{Template:Arraylist:Maximum footer}}

JALWiccan: 1 revision

2012-03-19T18:44:10Z

1 revision

← Older revision		Revision as of 18:44, 19 March 2012
Line 1:		Line 1:
	{{Template:Arraylist:Maximum subtitle}}		{{Template:Arraylist:Maximum subtitle}}
	<var>Maximum</var> returns the number of the <var>Arraylist</var> item that has the maximum numeric value after the application of a specified function to each item. The function that gets applied to each <var>Arraylist</var> item, which you identify using the <var class="term">method</var> argument, must be a method that operates on the item type and returns a User Language [[Intrinsic classes\|intrinsic]] datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value.		<var>Maximum</var> returns the number of the <var>Arraylist</var> item that has the maximum numeric value after the application of a specified function to each item. The function that gets applied to each <var>Arraylist</var> item, which you identify using the <var class="term">method</var> argument, must be a method that operates on the item type and returns a <var class="product">User Language</var> [[Intrinsic classes\|intrinsic]] datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value.

	==Syntax==		==Syntax==
Line 18:		Line 18:
	<ul><li>If the function applied by <var>Maximum</var> returns string values, <var>Maximum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the greatest value. Lowercase letters are first ranked alphabetically; then uppercase letters, also ranked alphabetically; finally followed by the numbers; that is: <code>'a'..'z','A'..'Z',0..9</code>.		<ul><li>If the function applied by <var>Maximum</var> returns string values, <var>Maximum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the greatest value. Lowercase letters are first ranked alphabetically; then uppercase letters, also ranked alphabetically; finally followed by the numbers; that is: <code>'a'..'z','A'..'Z',0..9</code>.
	<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.		<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.
	<li>The parameter for <var>Maximum</var> is a method value, not a User Language expression. That is, you cannot provide a function that itself has an argument (say, <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>(2)) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.		<li>The parameter for <var>Maximum</var> is a method value, not a <var class="product">User Language</var> expression. That is, you cannot provide a function that itself has an argument (say, <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>(2)) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.
	<li><var>Maximum</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.		<li><var>Maximum</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.
	</ul>		</ul>

JALWiccan: 1 revision

2011-05-04T17:45:56Z

1 revision

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

Goff: what was I thinking with those blank lines

2011-05-04T17:45:54Z

what was I thinking with those blank lines

← Older revision		Revision as of 17:45, 4 May 2011
Line 19:		Line 19:
	<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.		<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.
	<li>The parameter for <var>Maximum</var> is a method value, not a User Language expression. That is, you cannot provide a function that itself has an argument (say, <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>(2)) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.		<li>The parameter for <var>Maximum</var> is a method value, not a User Language expression. That is, you cannot provide a function that itself has an argument (say, <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>(2)) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.
	<li><var>Maximum</var> is available in <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.3 and later.		<li><var>Maximum</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.
	</ul>		</ul>

Goff: what was I thinking with those blank lines

2011-03-11T07:11:27Z

what was I thinking with those blank lines

← Older revision		Revision as of 07:11, 11 March 2011
Line 1:		Line 1:
	{{Template:Arraylist:Maximum subtitle}}		{{Template:Arraylist:Maximum subtitle}}

	<var>Maximum</var> returns the number of the <var>Arraylist</var> item that has the maximum numeric value after the application of a specified function to each item. The function that gets applied to each <var>Arraylist</var> item, which you identify using the <var class="term">method</var> argument, must be a method that operates on the item type and returns a User Language [[Intrinsic classes\|intrinsic]] datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value.		<var>Maximum</var> returns the number of the <var>Arraylist</var> item that has the maximum numeric value after the application of a specified function to each item. The function that gets applied to each <var>Arraylist</var> item, which you identify using the <var class="term">method</var> argument, must be a method that operates on the item type and returns a User Language [[Intrinsic classes\|intrinsic]] datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value.

Goff: once more with feelling

2011-03-08T09:50:27Z

once more with feelling

← Older revision		Revision as of 09:50, 8 March 2011
Line 7:		Line 7:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>%number</th><td>A numeric variable to return the item number of the item in the indicated <var>Arraylist</var> that has the maximum value after the argument function is applied.</td></tr>		<tr><th>%number</th>
	<tr><th>al</th><td>An <var>Arraylist</var> object.</td></tr>		<td>A numeric variable to return the item number of the item in the indicated <var>Arraylist</var> that has the maximum value after the argument function is applied.</td></tr>
	<tr><th>method</th><td>A method value (a method name literal, a method variable, or even a method that returns a method value) 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.		<tr><th>al</th>
	<p>As of <var class="product">Sirius Mods</var> ~~version~~ 7.6, the special identity function, <var>This</var> is the default <var class="term">method</var> value for the <var>Maximum</var> and <var>Minimum</var> methods. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]] for more information.</p></td></tr>		<td>An <var>Arraylist</var> object.</td></tr>
			<tr><th>method</th>
			<td>A <var class="term">method</var> value (a method name literal, a method variable, or even a method that returns a method value) 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.
			<p>As of <var class="product">Sirius Mods</var> Version 7.6, the special identity function, <var>This</var> is the default <var class="term">method</var> value for the <var>Maximum</var> and <var>Minimum</var> methods. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]] for more information.</p></td></tr>
	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul><li>If the function applied by <var>Maximum</var> returns string values, <var>Maximum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the greatest value. Lowercase letters are first ranked alphabetically, then uppercase letters, also ranked alphabetically, followed by the numbers; that is: <code>'a'..'z','A'..'Z',0..9</code>.		<ul><li>If the function applied by <var>Maximum</var> returns string values, <var>Maximum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the greatest value. Lowercase letters are first ranked alphabetically; then uppercase letters, also ranked alphabetically; finally followed by the numbers; that is: <code>'a'..'z','A'..'Z',0..9</code>.
	<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.		<li>If two or more <var>Arraylist</var> items have equal, maximum, values, <var>Maximum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.
	<li>The parameter for <var>Maximum</var> is a method value, not a User Language expression. That is, you cannot provide a function that itself has an argument (say, <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>(2)) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.		<li>The parameter for <var>Maximum</var> is a method value, not a User Language expression. That is, you cannot provide a function that itself has an argument (say, <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>(2)) as the <var>Maximum</var> parameter. The [[#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with <var>Maximum</var>.
	<li><var>Maximum</var> is available in <var class="product">Sirius Mods</var> ~~version~~ 7.3 and later.		<li><var>Maximum</var> is available in <var class="product">[[Sirius Mods\|"Sirius Mods"]]</var> Version 7.3 and later.
	~~<li><var>[[Minimum (Arraylist function)\|Minimum]]</var> is the opposite of the <var>Maximum</var> function~~.
	</ul>		</ul>

Line 25:		Line 27:
	In the following example, the <var>Maximum</var> and <var>Minimum</var> functions first apply the <var>Stringlist</var> <var>[[Count (Stringlist function)\|Count]]</var> function, then return the position of the <var>Arraylist</var> item <var>Stringlist</var> that has the most items and the one that has the fewest. The <var>Stringlist</var> <var>[[List (Stringlist function)\|List]]</var> function simplifies the construction of the lists.		In the following example, the <var>Maximum</var> and <var>Minimum</var> functions first apply the <var>Stringlist</var> <var>[[Count (Stringlist function)\|Count]]</var> function, then return the position of the <var>Arraylist</var> item <var>Stringlist</var> that has the most items and the one that has the fewest. The <var>Stringlist</var> <var>[[List (Stringlist function)\|List]]</var> function simplifies the construction of the lists.
	<p class="code">begin		<p class="code">begin
	%list1 is object stringlist		%list1 is object stringlist
	%list2 is object stringlist		%list2 is object stringlist
	%list3 is object stringlist		%list3 is object stringlist

	%list1 = List('the', 'quick', 'brown')		%list1 = List('the', 'quick', 'brown')
	%list2 = List('fox', 'jumped', 'over', 'the')		%list2 = List('fox', 'jumped', 'over', 'the')
	%list3 = List('lazy', 'dog', 'yesterday', 'two', 'times')		%list3 = List('lazy', 'dog', 'yesterday', 'two', 'times')

	al is collection arraylist of object stringlist		al is collection arraylist of object stringlist
	al = List(%list1, %list2, %list3)		al = List(%list1, %list2, %list3)

	[[PrintText statement\|printText]] {~} is {al:maximum(count)}		[[PrintText statement\|printText]] {~} is {al:maximum(count)}
	printText {~} is {al:minimum(count)}		printText {~} is {al:minimum(count)}
	end		end
	</p>		</p>
Line 49:		Line 51:
	The local method used with <var>Maximum</var> in the following request applies <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>, which (because it requires its own argument) the syntax of <var>Maximum</var> does not allow as a parameter.		The local method used with <var>Maximum</var> in the following request applies <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var>, which (because it requires its own argument) the syntax of <var>Maximum</var> does not allow as a parameter.
	<p class="code">begin		<p class="code">begin
	%alist is collection arraylist of float		%alist is collection arraylist of float
	%alist = List(10, -11, 0, 11)		%alist = List(10, -11, 0, 11)

	local function (float):Squared is float		local function (float):Squared is float
	return %this:toIntegerPower(2)		return %this:toIntegerPower(2)
	end function		end function

	printText {~} is {%alist:maximum(Squared)}		printText {~} is {%alist:maximum(Squared)}
	printText {~} is {%alist:minimum(Squared)}		printText {~} is {%alist:minimum(Squared)}
	end		end
	</p>		</p>
Line 69:		Line 71:

	==See also==		==See also==
			<ul><li><var>[[Minimum (Arraylist function)\|Minimum]]</var> is the opposite of the <var>Maximum</var> function.</ul>
	{{Template:Arraylist:Maximum footer}}		{{Template:Arraylist:Maximum footer}}