MaximumItem (Arraylist function)

From m204wiki
Revision as of 22:16, 18 July 2012 by JAL2 (talk | contribs) (→‎Examples)
Jump to navigation Jump to search

Get item that has maximum value (Arraylist class)

[Introduced in Sirius Mods 7.8]


MaximumItem is related to the Maximum Arraylist method, which returns the number or name of the item that has the maximum value in an Arraylist.

Syntax

%item = al:MaximumItem[( [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 MaximumItem method's item evaluation. If your Arraylist items are not intrinsic values, you must specify a method function that can map the item values to intrinsic values or the method will fail.

Examples

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

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

The result is:

%al:maximumItem=9 %al:maximum=5

See also