$min returns the minimum from a list of tokens. $min and $max are effectively a short-cut to returning either the first or last token from a $sorttok list, and uses different .prop settings to replicate the different switches used by $sorttok. By default, $min and $max sort the tokens with the same rules used by the $sorttok 'n' switch.
Synopsis[edit]
$min(<space delimited tokens>) $min(<comma,delimited,tokens>)
Parameters[edit]
- <list> - If only 1 parameter is passed, that parameter must be a list of tokens space delimited. Otherwise each parameter passed represent an element in the list.
Properties[edit]
- .text - sorts tokens using the same text sorting rules used by $sorttok 'a' switch
- .textcs - sorts tokens using the same text sorting rules used by $sorttokcs 'a' switch
- .nick - sorts tokens using the same text sorting rules used by $sorttok 'c' switch
Examples[edit]
//echo -a $min(11 2 3 5 8 13) $min(11,2,3,5,8,13)
//echo -a $min(c C).text vs $min(c C).textcs
Returns "c vs C" because, as case-insensitive text, 'C' and 'c' are the same, so the leftmost of the pair is returned.
Numeric sorting rules recognize exponential, so $min(1e2 1d2) handles both of them as 100.
//echo -a $min( 1:black 02:blue 14:grey 3:green 13:magenta 5:maroon 6:purple 04:red 7:tan 8:yellow 0:white)
result: 0:white
Using the .nick property is the same as using the 'c' switch with $sorttok, where the sorting alphabet is altered to place the ranks to the minimum in the order they appear in the $prefix output, which can possibly be a different result in windows attached to different networks:
//echo -a $asc(@) $asc(%) $asc(+) $min(@nick % $+ nick +nick).nick vs $min(@nick % $+ nick +nick).text
Compatibility[edit]
Added: mIRC v7.62
Added on: 29 Jul 2020
Note: Unless otherwise stated, this was the date of original functionality.
Further enhancements may have been made in later versions.