maxBy<S, T> function

S maxBy <S, T>(
  1. Iterable<S> values,
  2. T orderBy(
    1. S element
  3. {int compare(
    1. T value1,
    2. T value2

Returns the element of values for which orderBy returns the maximum value.

The values returned by orderBy are compared using the compare function. If compare is omitted, values must implement Comparable<T> and they are compared using their Comparable.compareTo.


S maxBy<S, T>(Iterable<S> values, T orderBy(S element),
    {int compare(T value1, T value2)}) {
  compare ??= defaultCompare<T>();

  S maxValue;
  T maxOrderBy;
  for (var element in values) {
    var elementOrderBy = orderBy(element);
    if (maxOrderBy == null || compare(elementOrderBy, maxOrderBy) > 0) {
      maxValue = element;
      maxOrderBy = elementOrderBy;
  return maxValue;