Minimum (UnicodeNamedArraylist function) - Revision history

JAL: /* Usage notes */

2012-11-01T20:35:33Z

Usage notes

← Older revision		Revision as of 20:35, 1 November 2012
Line 21:		Line 21:
	<ul>		<ul>
	<li>If <var class="term">itemFunction</var> returns <var>String</var> or <var>Unicode</var> values, <var>Minimum</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine which item has the least value. If <var class="term">itemFunction</var> returns a numeric type, numeric comparisons are used. See the [[Minimum (NamedArraylist function)#Examples\|"example"]] for the <var>NamedArraylist</var> <var>Minimum</var> function.		<li>If <var class="term">itemFunction</var> returns <var>String</var> or <var>Unicode</var> values, <var>Minimum</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine which item has the least value. If <var class="term">itemFunction</var> returns a numeric type, numeric comparisons are used. See the [[Minimum (NamedArraylist function)#Examples\|"example"]] for the <var>NamedArraylist</var> <var>Minimum</var> function.

	<li>If the values returned by <var class="term">itemFunction</var> for two or more <var>UnicodeNamedArraylist</var> items are equal, minimum, values, <var>Minimum</var> returns the name of that item which is closest to the beginning of the <var>UnicodeNamedArraylist</var>.		<li>If the values returned by <var class="term">itemFunction</var> for two or more <var>UnicodeNamedArraylist</var> items are equal, minimum, values, <var>Minimum</var> returns the name of that item which is closest to the beginning of the <var>UnicodeNamedArraylist</var>.

	<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the <var>Minimum</var> function.		<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the <var>Minimum</var> function.

	<li>The <var class="term">itemFunction</var> argument is a method value, not a <var class="product">User Language</var> expression.		<li>The <var class="term">itemFunction</var> argument 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		That is, you cannot provide a function that itself has an argument
	(say, <tt>ToIntegerPower(2)</tt>) as <var class="term">itemFunction</var>.		(say, <code>ToIntegerPower(2)</code>) as <var class="term">itemFunction</var>.
	Example [[Maximum (Arraylist function)\|"Maximum/Minimum with local method"]] shows a way to apply <var>ToIntegerPower</var>		Example [[Maximum (Arraylist function)\|"Maximum/Minimum with local method"]] shows a way to apply <var>[[ToIntegerPower (Float function)\|ToIntegerPower]]</var>
	with <var>Maximum</var> or <var>Minimum</var> for an <var>Arraylist</var>.		with <var>Maximum</var> or <var>Minimum</var> for an <var>Arraylist</var>.
	</ul>		</ul>

	==Examples==		==Examples==
	For examples of <var>Minimum</var> (and <var>Maximum</var>) calls, see the [[Minimum (FloatNamedArraylist function)#Examples\|"FloatNamedArraylist Minimum function example"]] in		For examples of <var>Minimum</var> (and <var>Maximum</var>) calls, see the [[Minimum (FloatNamedArraylist function)#Examples\|"FloatNamedArraylist Minimum function example"]] in

Dme at 23:23, 10 August 2012

2012-08-10T23:23:28Z

← Older revision		Revision as of 23:23, 10 August 2012
Line 1:		Line 1:
	{{Template:UnicodeNamedArraylist:Minimum subtitle}}		{{Template:UnicodeNamedArraylist:Minimum subtitle}}

	~~This function~~ returns the name ~~(subscript)~~ of the <var>UnicodeNamedArraylist</var> item that		<var>Minimum</var> returns the name of the <var>UnicodeNamedArraylist</var> item that has the minimum value as returned by a specified function. The function applied to each <var>UnicodeNamedArraylist</var> item, which you specify with the required <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>, or <var>Unicode</var>) value.
	has the minimum value ~~after the application of~~ a specified function ~~to each item~~.
	The function ~~that gets~~ applied to each <var>UnicodeNamedArraylist</var> item, which
	you ~~identify in~~ the ~~argument to~~ <var>~~Minimum~~</var>, 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:UnicodeNamedArraylist:Minimum syntax}}		{{Template:UnicodeNamedArraylist:Minimum syntax}}
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>unicode</th>		<tr><th>%unicode</th>
	<td>A ~~<var>~~Unicode~~</var> string~~ to contain the ~~subscript~~ name of the item in ~~<var class="term">uniNal</var>,~~ the ~~method~~ <var>UnicodeNamedArraylist</var> ~~object,~~ that has the minimum value ~~after~~ the argument function ~~has been applied~~. </td></tr>		<td>A Unicode variable to contain the name of the item in the indicated <var>UnicodeNamedArraylist</var>that has the minimum value as returned by the argument function. </td></tr>
	<tr><th>uniNal</th>		<tr><th>uniNal</th>
	<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>		<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>
	<tr><th>itemFunction</th>		<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 objects of the type specified on the <var class="term">uniNal</var> declaration and that returns ~~a numeric or string~~ value.		<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 objects of the type specified on the <var class="term">uniNal</var> declaration and that returns an intrinsic value.

	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 <var>This</var> function as the Maximum parameter"]].</td></tr>		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 <var>This</var> function as the Maximum parameter"]].</td></tr>

	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If <var class="term">itemFunction</var> returns ~~string~~ values, <var>Minimum</var>		<li>If <var class="term">itemFunction</var> returns <var>String</var> or <var>Unicode</var> values, <var>Minimum</var> uses the collating sequence of EBCDIC or Unicode, respectively, to determine which item has the least value. If <var class="term">itemFunction</var> returns a numeric type, numeric comparisons are used. See the [[Minimum (NamedArraylist function)#Examples\|"example"]] for the <var>NamedArraylist</var> <var>Minimum</var> function.
	uses the ~~decimal-equivalent value~~ of ~~the character bytes and determines~~		<li>If the values returned by <var class="term">itemFunction</var> for two or more <var>UnicodeNamedArraylist</var> items are equal, minimum, values, <var>Minimum</var> returns the name of that item which is closest to the beginning of the <var>UnicodeNamedArraylist</var>.
	~~the number of the~~ item ~~that~~ has the ~~lowest~~ value.
	~~Therefore, lowercase letters are ranked alphabetically and the minimum lowercase letter is~~ "a";
	~~the uppercase letters~~ are ~~ranked alphabetically and~~ the ~~minimum uppercase letter is~~ "A";
	~~"z" ranks lower than all~~ the ~~uppercase letters; and all letters rank lower than any number~~.
	<li>If ~~one~~ or more <var>UnicodeNamedArraylist</var> items ~~have~~ equal, minimum, values,
	<var>Minimum</var> returns the ~~subscript~~ of ~~the~~ item ~~that appears~~ closest to the beginning
	of the <var>UnicodeNamedArraylist</var>.
	<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the <var>Minimum</var> function.		<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the <var>Minimum</var> function.
	<li>The <var class="term">itemFunction</var> argument is a method value, not a <var class="product">User Language</var> expression.		<li>The <var class="term">itemFunction</var> argument is a method value, not a <var class="product">User Language</var> expression.
Line 41:		Line 29:
	with <var>Maximum</var> or <var>Minimum</var> for an <var>Arraylist</var>.		with <var>Maximum</var> or <var>Minimum</var> for an <var>Arraylist</var>.
	</ul>		</ul>
			==Examples==
			For examples of <var>Minimum</var> (and <var>Maximum</var>) calls, see the [[Minimum (FloatNamedArraylist function)#Examples\|"FloatNamedArraylist Minimum function example"]] in
			the <var>Minimum</var> method description, and [[Collections#Finding collection maxima and minima, and sorting\|"Finding collection maxima and minima, and sorting"]], and the [[Maximum (NamedArraylist function)#Examples\|"NamedArraylist Maximum function example"]].
	==See also==		==See also==
	{{Template:UnicodeNamedArraylist:Minimum footer}}		{{Template:UnicodeNamedArraylist:Minimum footer}}

JAL2 at 19:52, 19 March 2012

2012-03-19T19:52:32Z

← Older revision		Revision as of 19:52, 19 March 2012
Line 1:		Line 1:
	{{Template:UnicodeNamedArraylist:Minimum subtitle}}		{{Template:UnicodeNamedArraylist:Minimum subtitle}}

	This function returns the name (subscript) of the UnicodeNamedArraylist item that		This function returns the name (subscript) of the <var>UnicodeNamedArraylist</var> item that
	has the minimum value after the application of a specified function to each item.		has the minimum value after the application of a specified function to each item.
	The function that gets applied to each UnicodeNamedArraylist item, which		The function that gets applied to each <var>UnicodeNamedArraylist</var> item, which
	you identify in the argument to Minimum, must be a method		you identify in the argument to <var>Minimum</var>, must be a method
	that operates on the item type and returns a <var class="product">User Language</var> intrinsic		that operates on the item type and returns a <var class="product">User Language</var> [[Intrinsic classes\|intrinsic]]
	datatype (Float, String, Longstring, or Unicode) value.		datatype (<var>Float</var>, <var>String</var>, <var>Longstring</var>, or <var>Unicode</var>) value.

	~~The system intrinsic classes are discussed in [[Intrinsic classes\|"Intrinsic classes"]].~~
	~~Local methods are discussed in [[??]] refid=localm..~~
	==Syntax==		==Syntax==
	{{Template:UnicodeNamedArraylist:Minimum syntax}}		{{Template:UnicodeNamedArraylist:Minimum syntax}}
Line 19:		Line 17:
	<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>		<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>
	<tr><th>itemFunction</th>		<tr><th>itemFunction</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 objects of the type specified on the <var class="term">uniNal</var> declaration and that returns a numeric or string value.		<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 objects of the type specified on the <var class="term">uniNal</var> declaration and that returns a numeric or string value.

	The special identity function, <tt>This</tt>, is the default ~~''function''~~ 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"]].</td></tr>		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 <var>This</var> function as the Maximum parameter"]].</td></tr>

	</table>		</table>
Line 30:		Line 28:
	uses the decimal-equivalent value of the character bytes and determines		uses the decimal-equivalent value of the character bytes and determines
	the number of the item that has the lowest value.		the number of the item that has the lowest value.
	Therefore, lowercase letters are ranked alphabetically and		Therefore, lowercase letters are ranked alphabetically and the minimum lowercase letter is "a";
	the minimum lowercase letter is "a";		the uppercase letters are ranked alphabetically and the minimum uppercase letter is "A";
	the uppercase letters are ranked alphabetically and		"z" ranks lower than all the uppercase letters; and all letters rank lower than any number.
	the minimum uppercase letter is "A";
	"z" ranks lower than all the uppercase letters;
	and all letters rank lower than any number.
	<li>If one or more <var>UnicodeNamedArraylist</var> items have equal, minimum, values,		<li>If one or more <var>UnicodeNamedArraylist</var> items have equal, minimum, values,
	<var>Minimum</var> returns the subscript of the item that appears closest to the beginning		<var>Minimum</var> returns the subscript of the item that appears closest to the beginning

JALWiccan: 1 revision

2012-03-19T18:44:17Z

1 revision

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

Dme: /* Syntax terms */

2012-03-19T18:44:16Z

Syntax terms

← Older revision		Revision as of 18:44, 19 March 2012
Line 5:		Line 5:
	The function that gets applied to each UnicodeNamedArraylist item, which		The function that gets applied to each UnicodeNamedArraylist item, which
	you identify in the argument to Minimum, must be a method		you identify in the argument to Minimum, must be a method
	that operates on the item type and returns a User Language intrinsic		that operates on the item type and returns a <var class="product">User Language</var> intrinsic
	datatype (Float, String, Longstring, or Unicode) value.		datatype (Float, String, Longstring, or Unicode) value.

Line 40:		Line 40:
	of the <var>UnicodeNamedArraylist</var>.		of the <var>UnicodeNamedArraylist</var>.
	<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the <var>Minimum</var> function.		<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the <var>Minimum</var> function.
	<li>The <var class="term">itemFunction</var> argument is a method value, not a User Language expression.		<li>The <var class="term">itemFunction</var> argument 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		That is, you cannot provide a function that itself has an argument
	(say, <tt>ToIntegerPower(2)</tt>) as <var class="term">itemFunction</var>.		(say, <tt>ToIntegerPower(2)</tt>) as <var class="term">itemFunction</var>.

Dme: /* Syntax terms */

2012-02-08T12:36:04Z

Syntax terms

← Older revision		Revision as of 12:36, 8 February 2012
Line 15:		Line 15:
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>unicode</th>		<tr><th>unicode</th>
	<td>A <var>Unicode</var> string to contain the subscript name of the item in ~~the~~ <var class="term">uniNal</var> method <var>UnicodeNamedArraylist</var> object that has the minimum value after the argument function has been applied. </td></tr>		<td>A <var>Unicode</var> string to contain the subscript name of the item in <var class="term">uniNal</var>, the method <var>UnicodeNamedArraylist</var> object, that has the minimum value after the argument function has been applied. </td></tr>
	<tr><th>uniNal</th>		<tr><th>uniNal</th>
	<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>		<td>A <var>UnicodeNamedArraylist</var> object. </td></tr>
Line 24:		Line 24:

	</table>		</table>

	==Usage notes==		==Usage notes==
	<ul>		<ul>

Dme at 12:33, 8 February 2012

2012-02-08T12:33:18Z

← Older revision		Revision as of 12:33, 8 February 2012
Line 14:		Line 14:
	===Syntax terms===		===Syntax terms===
	<table class="syntaxTable">		<table class="syntaxTable">
	<tr><th>~~name~~</th>		<tr><th>unicode</th>
	<td>A Unicode string to contain the subscript name of the item in the ~~indicated~~ UnicodeNamedArraylist that has the minimum value after the argument function has been applied. </td></tr>		<td>A <var>Unicode</var> string to contain the subscript name of the item in the <var class="term">uniNal</var> method <var>UnicodeNamedArraylist</var> object that has the minimum value after the argument function has been applied. </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>~~function~~</th>		<tr><th>itemFunction</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 objects of the type specified on the ~~''%unamrayl''~~ 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 objects of the type specified on the <var class="term">uniNal</var> declaration and that returns a numeric or string value.

	The special identity function, <tt>This</tt>, is the default ''function'' value for the Maximum and Minimum methods. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]].</td></tr>		The special identity function, <tt>This</tt>, is the default ''function'' 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"]].</td></tr>

	</table>		</table>
	==Usage notes==		==Usage notes==
	<ul>		<ul>
	<li>If ~~the function applied by Minimum~~ returns string values, Minimum		<li>If <var class="term">itemFunction</var> returns string values, <var>Minimum</var>
	uses the decimal-equivalent value of the character bytes and determines		uses the decimal-equivalent value of the character bytes and determines
	the number of the item that has the lowest value.		the number of the item that has the lowest value.
Line 35:		Line 35:
	"z" ranks lower than all the uppercase letters;		"z" ranks lower than all the uppercase letters;
	and all letters rank lower than any number.		and all letters rank lower than any number.
	<li>If one or more UnicodeNamedArraylist items have equal, minimum, values,		<li>If one or more <var>UnicodeNamedArraylist</var> items have equal, minimum, values,
	Minimum returns the subscript of the item that appears closest to the beginning		<var>Minimum</var> returns the subscript of the item that appears closest to the beginning
	of the UnicodeNamedArraylist.		of the <var>UnicodeNamedArraylist</var>.
	<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the Minimum function.		<li>The [[Maximum (UnicodeNamedArraylist function)\|Maximum]] function is the opposite of the <var>Minimum</var> function.
	<li>The ~~parameter for Minimum~~ is a method value, not a User Language expression.		<li>The <var class="term">itemFunction</var> argument is a method value, not a User Language expression.
	That is, you cannot provide a function that itself has an argument		That is, you cannot provide a function that itself has an argument
	(say, <tt>ToIntegerPower(2)</tt>) as ~~the Minimum parameter~~.		(say, <tt>ToIntegerPower(2)</tt>) as <var class="term">itemFunction</var>.
	Example [[Maximum (Arraylist function)\|"Maximum/Minimum with local method"]] shows a way to apply ToIntegerPower		Example [[Maximum (Arraylist function)\|"Maximum/Minimum with local method"]] shows a way to apply <var>ToIntegerPower</var>
	with Maximum or Minimum for an Arraylist.		with <var>Maximum</var> or <var>Minimum</var> for an <var>Arraylist</var>.
	</ul>		</ul>
	==See also==		==See also==
	{{Template:UnicodeNamedArraylist:Minimum footer}}		{{Template:UnicodeNamedArraylist:Minimum footer}}

JAL at 23:15, 2 March 2011

2011-03-02T23:15:49Z

← Older revision		Revision as of 23:15, 2 March 2011
Line 8:		Line 8:
	datatype (Float, String, Longstring, or Unicode) value.		datatype (Float, String, Longstring, or Unicode) value.

	The system intrinsic classes are discussed in "[[Intrinsic classes]]".		The system intrinsic classes are discussed in [[Intrinsic classes\|"Intrinsic classes"]].
	Local methods are discussed in [[??]] refid=localm..		Local methods are discussed in [[??]] refid=localm..
	==Syntax==		==Syntax==
Line 21:		Line 21:
	<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 objects of the type specified on the ''%unamrayl'' 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 objects of the type specified on the ''%unamrayl'' declaration and that returns a numeric or string value.

	The special identity function, <tt>This</tt>, is the default ''function'' value for the Maximum and Minimum methods. See [[Collections#Using the This function as the Maximum parameter\|Using the This function as the Maximum parameter]].</td></tr>		The special identity function, <tt>This</tt>, is the default ''function'' value for the Maximum and Minimum methods. See [[Collections#Using the This function as the Maximum parameter\|"Using the This function as the Maximum parameter"]].</td></tr>

	</table>		</table>
Line 42:		Line 42:
	That is, you cannot provide a function that itself has an argument		That is, you cannot provide a function that itself has an argument
	(say, <tt>ToIntegerPower(2)</tt>) as the Minimum parameter.		(say, <tt>ToIntegerPower(2)</tt>) as the Minimum parameter.
	Example "[[Maximum (Arraylist function)\|Maximum/Minimum with local method]]" shows a way to apply ToIntegerPower		Example [[Maximum (Arraylist function)\|"Maximum/Minimum with local method"]] shows a way to apply ToIntegerPower
	with Maximum or Minimum for an Arraylist.		with Maximum or Minimum for an Arraylist.
	</ul>		</ul>
	==See also==		==See also==
	{{Template:UnicodeNamedArraylist:Minimum footer}}		{{Template:UnicodeNamedArraylist:Minimum footer}}

Wiccan: 1 revision

2011-02-08T18:23:44Z

1 revision

← Older revision		Revision as of 18:23, 8 February 2011
Line 20:		Line 20:
	<tr><th>function</th>		<tr><th>function</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 objects of the type specified on the ''%unamrayl'' 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 objects of the type specified on the ''%unamrayl'' declaration and that returns a numeric or string value.
	~~<p class="code">~~The special identity function, <tt>This</tt>, is the default ''function'' value for the Maximum and Minimum methods. See [[Collections#Using the This function as the Maximum parameter\|Using the This function as the Maximum parameter]].</td></tr>
	~~</p>~~		The special identity function, <tt>This</tt>, is the default ''function'' value for the Maximum and Minimum methods. See [[Collections#Using the This function as the Maximum parameter\|Using the This function as the Maximum parameter]].</td></tr>

	</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)