maxIndexBy<T, R extends Comparable?> function Summarizing data

int maxIndexBy<T, R extends Comparable?>(
  1. Iterable<T> iterable,
  2. R accessor(
    1. T
    )
)

Returns the index of the maximum of all values yielded by the accessor function applied to each element in the iterable.

The maximum is determined based on the natural ordering of the values, as defined by the Comparable interface.

This function ignores elements that yield values that do not satisfy any of the following conditions:

  1. The value is not null.
  2. The value is not a special case like double.nan, which does not satisfy self-equality according to Object.==.

Useful for filtering and ignoring missing data in datasets.

If the iterable is empty or contains no elements that yield valid values, this function returns -1.

Implementation

int maxIndexBy<T, R extends Comparable?>(
    Iterable<T> iterable, R Function(T) accessor) {
  R? max;
  var maxIndex = -1, index = -1;
  for (final element in iterable) {
    ++index;
    final value = accessor(element);
    if (value == null || value != value) continue;
    if (max == null || max.compareTo(value) < 0) {
      max = value;
      maxIndex = index;
    }
  }
  return maxIndex;
}