Minimum (Arraylist function) - Revision history

JAL: /* See also */

2012-11-01T16:15:07Z

JAL2: /* Usage notes */

2012-08-13T19:30:07Z

Usage notes

← Older revision		Revision as of 19:30, 13 August 2012
Line 19:		Line 19:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the function applied by <var>Minimum</var> returns <var>String</var> or <var>Unicode</var> values, <var>Minimum</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine the number of the item that has the lowest value.		<li>If the function applied by <var>Minimum</var> returns <var>String</var> or <var>Unicode</var> values, <var>Minimum</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine the number of the item that has the lowest value. If the function returns a numeric type, numeric comparisons are used.

	<li>If one or more <var>Arraylist</var> items have equal, minimum, values, <var>Minimum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.		<li>If one or more <var>Arraylist</var> items have equal, minimum, values, <var>Minimum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.

JAL2: /* Usage notes */

2012-08-09T23:39:53Z

Usage notes

← Older revision		Revision as of 23:39, 9 August 2012
Line 19:		Line 19:
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If the function applied by <var>Minimum</var> returns ~~string~~ values, <var>Minimum</var> uses the ~~decimal-equivalent value~~ of ~~the character bytes and determines~~ the number of the item that has the lowest value. ~~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>Minimum</var> returns <var>String</var> or <var>Unicode</var> values, <var>Minimum</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine the number of the item that has the lowest value.

	<li>If one or more <var>Arraylist</var> items have equal, minimum, values, <var>Minimum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.		<li>If one or more <var>Arraylist</var> items have equal, minimum, values, <var>Minimum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.

	<li>The parameter for <var>Minimum</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>Minimum</var> parameter. See the [[Maximum (Arraylist function)#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example, which shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with the <var>Maximum</var> or <var>Minimum</var> method.		<li>The parameter for <var>Minimum</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>Minimum</var> parameter. See the [[Maximum (Arraylist function)#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example, which shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with the <var>Maximum</var> or <var>Minimum</var> method.

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

JAL2 at 16:44, 27 July 2012

2012-07-27T16:44:50Z

← Older revision		Revision as of 16:44, 27 July 2012
Line 4:		Line 4:
	==Syntax==		==Syntax==
	{{Template:Arraylist:Minimum syntax}}		{{Template:Arraylist:Minimum syntax}}

	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<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 minimum value after the argument method has been applied. </td></tr>		<td>A numeric variable to return the item number of the item in the indicated <var>Arraylist</var> that has the minimum value after the argument method has been 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>
	<td>A method value (a method name literal, a [[Method variables\|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 <var>[[Maximum (Arraylist function)\|Maximum]]</var> and <var>Minimum</var>. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]].</p></td></tr>		<tr><th>itemFunction</th>
			<td>A method value (a method name literal, a [[Method variables\|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">itemFunction</var> value for <var>[[Maximum (Arraylist function)\|Maximum]]</var> and <var>Minimum</var>. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]].</p></td></tr>
	</table>		</table>

JAL2: /* Examples */

2012-03-19T18:46:47Z

Examples

← Older revision		Revision as of 18:46, 19 March 2012
Line 23:		Line 23:

	==Examples==		==Examples==
	~~<ol>~~		In the following example, <var>Minimum</var> and <var>[[Maximum (Arraylist function)\|Maximum]]</var> use the special method, <var>This</var>, which simply returns the item value. The <var>[[List (Arraylist function)\|List]]</var> function simplifies the construction of the <var>Arraylist</var>.
	~~<li>~~In the following example, <var>Minimum</var> and <var>[[Maximum (Arraylist function)\|Maximum]]</var> use the special method, <var>This</var>, which simply returns the item value. The <var>[[List (Arraylist function)\|List]]</var> function simplifies the construction of the <var>Arraylist</var>.
	<p class="code">begin		<p class="code">begin
	%alist is collection arraylist of string len 12		%alist is collection arraylist of string len 12
Line 38:		Line 37:
	<p class="output">%alist:minimum(this) is 1		<p class="output">%alist:minimum(this) is 1
	%alist:maximum(this) is 4		%alist:maximum(this) is 4
	</p~~></ol~~>		</p>

	==See also==		==See also==
	<ul><li>The <var>[[Maximum (Arraylist function)\|Maximum]]</var> function is the opposite of the <var>Minimum</var> function.<li>For additional <var>Minimum</var> and <var>Maximum</var> examples, see the [[Maximum (Arraylist function)#Examples\|Arraylist Maximum function examples]] and [[Collections#Finding collection maxima and minima, and sorting\|"Finding collection maxima and minima, and sorting"]].</ul>		<ul><li>The <var>[[Maximum (Arraylist function)\|Maximum]]</var> function is the opposite of the <var>Minimum</var> function.<li>For additional <var>Minimum</var> and <var>Maximum</var> examples, see the [[Maximum (Arraylist function)#Examples\|Arraylist Maximum function examples]] and [[Collections#Finding collection maxima and minima, and sorting\|"Finding collection maxima and minima, and sorting"]].</ul>
	{{Template:Arraylist:Minimum footer}}		{{Template:Arraylist:Minimum footer}}

JALWiccan: 1 revision

2012-03-19T18:44:11Z

1 revision

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

JALWiccan: 1 revision

2012-03-19T18:44:10Z

1 revision

← Older revision		Revision as of 18:44, 19 March 2012
Line 18:		Line 18:
	<li>If the function applied by <var>Minimum</var> returns string values, <var>Minimum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the lowest value. 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>Minimum</var> returns string values, <var>Minimum</var> uses the decimal-equivalent value of the character bytes and determines the number of the item that has the lowest value. 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 one or more <var>Arraylist</var> items have equal, minimum, values, <var>Minimum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.		<li>If one or more <var>Arraylist</var> items have equal, minimum, values, <var>Minimum</var> returns the position of the item that appears closest to the beginning of the <var>Arraylist</var>.
	<li>The parameter for <var>Minimum</var> is a method value, not a User Language expression. That is, you cannot provide a function that itself has an argument (say, <code>ToIntegerPower(2)</code>) as the <var>Minimum</var> parameter. See the [[Maximum (Arraylist function)#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example, which shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with the <var>Maximum</var> or <var>Minimum</var> method.		<li>The parameter for <var>Minimum</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>Minimum</var> parameter. See the [[Maximum (Arraylist function)#Maximum and Minimum with local method\|"Maximum and Minimum with local method"]] example, which shows a way to apply <var>[[ToIntegerPower and ToPower (Float functions)\|ToIntegerPower]]</var> with the <var>Maximum</var> or <var>Minimum</var> method.
	<li><var>Minimum</var> is available in <var class="product">[[Sirius Mods\|Sirius Mods]]</var> Version 7.3 and later.		<li><var>Minimum</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 at 17:45, 4 May 2011

2011-05-04T17:45:54Z

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

Goff at 07:15, 11 March 2011

2011-03-11T07:15:41Z

← Older revision		Revision as of 07:15, 11 March 2011
Line 26:		Line 26:
	<li>In the following example, <var>Minimum</var> and <var>[[Maximum (Arraylist function)\|Maximum]]</var> use the special method, <var>This</var>, which simply returns the item value. The <var>[[List (Arraylist function)\|List]]</var> function simplifies the construction of the <var>Arraylist</var>.		<li>In the following example, <var>Minimum</var> and <var>[[Maximum (Arraylist function)\|Maximum]]</var> use the special method, <var>This</var>, which simply returns the item value. The <var>[[List (Arraylist function)\|List]]</var> function simplifies the construction of the <var>Arraylist</var>.
	<p class="code">begin		<p class="code">begin
	%alist is collection arraylist of string len 12		%alist is collection arraylist of string len 12

	%alist = ~~List~~('broken', 'br4ck', 'brown', 'Box', 'bumped')		%alist = [[List_(Arraylist_function)\|list]]('broken', 'br4ck', 'brown', 'Box', 'bumped')

	~~[[PrintText statement\|printText]]t {~} is {%alist:minimum(this)}~~
	~~printText {~} is {%alist:maximum(this)}~~

			[[PrintText statement\|printText]] {~} is {%alist:minimum(this)}
			printText {~} is {%alist:maximum(this)}
	end		end
	</p>		</p>

← Older revision		Revision as of 16:15, 1 November 2012
Line 46:		Line 46:

	==See also==		==See also==
	<ul><li>The <var>[[Maximum (Arraylist function)\|Maximum]]</var> function is the opposite of the <var>Minimum</var> function.<li>For additional <var>Minimum</var> and <var>Maximum</var> examples, see the [[Maximum (Arraylist function)#Examples\|Arraylist Maximum function examples]] and [[Collections#Finding collection maxima and minima, and sorting\|"Finding collection maxima and minima, and sorting"]].</ul>		<ul>
			<li>The <var>[[Maximum (Arraylist function)\|Maximum]]</var> function is the opposite of the <var>Minimum</var> function.

			<li>For additional <var>Minimum</var> and <var>Maximum</var> examples, see the [[Maximum (Arraylist function)#Examples\|Arraylist Maximum function examples]] and [[Collections#Finding collection maxima and minima, and sorting\|"Finding collection maxima and minima, and sorting"]].
			</ul>

	{{Template:Arraylist:Minimum footer}}		{{Template:Arraylist:Minimum footer}}