Documentation for routine
max assembled from the following types:
Returns the largest of the arguments, as determined by cmp semantics.
my = -42;max= 0 # read as: $foo increases to 0
multi method max()multi method max()multi sub max(+args, :!)multi sub max(+args)
Coerces the invocant to Iterable and returns the numerically largest element; in the case of
Pair with the highest value.
If a Callable positional argument is provided, each value is passed into the filter, and the return value is compared instead of the original value. The original value is still the one returned from
sub form, the invocant is passed as an argument and a comparison
Callable can be specified with the named argument
say (1,7,3).max(); # OUTPUT:«7␤»say (1,7,3).max(); # OUTPUT:«1␤»say max(1,7,3,:by( )); # OUTPUT: «1␤»say max(1,7,3); # OUTPUT: «7␤»max( %(a => 'B', b=> 'C' ) ).say; # OUTPUT: «b => C␤»
method max(Supply: = :<cmp> --> Supply)
Creates a supply that only emits values from the given supply if they are larger than any value seen before. In other words, from a continuously ascending supply it will emit all the values. From a continuously descending supply it will only emit the first value. The optional parameter specifies the comparator, just as with Any.max.
Returns the end point of the range.
say (1..5).max; # OUTPUT: «5␤»say (1^..^5).max; # OUTPUT: «5␤»