MinimumItem (Arraylist function): Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
Line 25: Line 25:


==Examples==
==Examples==
For the <var>ArrayList</var> <code>%al</code> whose items are the odd integers between 0 and 10, <code>%al:minItem</code> returns <code>1</code>.
For the <var>ArrayList</var> <code>%al</code> whose items are the odd integers between 10 and 0, <var>MinimumItem</var> returns the value of the item that has the minimum value, while <var>Minimum</var> returns the index (item number) of that item:
<p class="code">b                                 
                                   
%al  is arraylist of float         
%al = list(9,7,5,3,1)
 
printText {~=%al:minimumItem}
printText {~=%al:minimum}
end </p>
 
The result is:
<p class="output">%al:minimumItem=1  
%al:minimum=5 </p>


==See also==
==See also==
{{Template:Arraylist:MinimumItem footer}}
{{Template:Arraylist:MinimumItem footer}}

Revision as of 22:13, 18 July 2012

Get item that has minimum value (Arraylist class)

[Introduced in Sirius Mods 7.8]


MinimumItem is related to the Minimum Arraylist method, which returns the number or name of the item that has the minimum value in an Arraylist.

Syntax

%item = al:MinimumItem[( [itemFunction])]

Syntax terms

%item An Arraylist item of the same type as the al object.
al An Arraylist object.
method A function that operates on the type of the items in the Arraylist. It may be a local method or method variable or a class member (Variable, Property), and it must return an intrinsic value. The default method value is the special identity function, This, which simply returns the item value.

Usage notes

  • The optional method parameter lets you further manipulate the Arraylist item values before performing the MinimumItem method's item evaluation. The method default (identity function This) fails against non-intrinsic values, however. If your Arraylist items are not intrinsic values, you must specify a method function that can map the item values to intrinsic values.

Examples

For the ArrayList %al whose items are the odd integers between 10 and 0, MinimumItem returns the value of the item that has the minimum value, while Minimum returns the index (item number) of that item:

b %al is arraylist of float %al = list(9,7,5,3,1) printText {~=%al:minimumItem} printText {~=%al:minimum} end

The result is:

%al:minimumItem=1 %al:minimum=5

See also