selectMax: Difference between revisions

Revision as of 10:24, 13 May 2022

Hover & click on the images for description

Description:: Returns the array element with maximum numerical value. Engine solution to BIS_fnc_greatestNum and BIS_fnc_findExtreme. Therefore it is expected that supplied array consists of Numbers only. Booleans however are also supported and will be evaluated as Numbers: true - 1, false - 0. nil value treated as 0.
⚠
Other non Number elements (not recommended) will be evaluated as 0 and Bad conversion: scalar message will be logged into .rpt.
Groups:: Arrays

Example 1:: _max = selectMax [1,2,3,4,5]; //5
Example 2:: // Same as, for example: _max = _a max _b max _c max _d; // Only faster: _max = selectMax [_a,_b,_c,_d];

: Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note

: Posted on December 19, 2016 - 02:05 (UTC)
Longbow: Returns either number or boolean value, in case max value in array 0, command will return either 0 or false, which ever comes first. Same for 1 and true values. selectMax [false,0] // returns false selectMax [0,false] // returns 0 selectMax [true,1] // returns true selectMax [1,true] // returns 1 in case all values are equal or less than zero, command may also return other type of values selectMax ["",false,0,-1] // returns "" if nil value appears in array, other values are equal or less than zero, command returns nil

@@ Line 15: / Line 15: @@
 |r1= [[Anything]] - element with [[max]]imum numerical value
-|x1= <code>_max = selectMax [1,2,3,4,5]; //5</code>
+|x1= <sqf>_max = selectMax [1,2,3,4,5]; //5</sqf>
-|x2= <code>// Same as, for example:
+|x2= <sqf>// Same as, for example:
 _max = _a max _b max _c max _d;
 // Only faster:
-_max = selectMax [_a,_b,_c,_d];</code>
+_max = selectMax [_a,_b,_c,_d];</sqf>
 |seealso= [[selectMin]] [[min]] [[max]] [[selectRandom]] [[select]] [[selectRandomWeighted]]