Interface IterableByExtremumProvider<E>

Type Parameters:

E - the type of the elements a IterableByExtremumProvider

All Known Subinterfaces:

ExtendedIterable<E>, IAppendableList<E>, IArrayList<E>, ILinkedList<E>, IMatrix<E>, IMatrixColumn<E>, IMatrixRow<E>, ISqlRecord

All Known Implementing Classes:

AbstractExtendedIterable, ArrayExtendedIterableView, ArrayList, ExtendedIterableFilterView, ExtendedIterableIntervalView, ExtendedIterableMapperView, ExtendedIterableView, ImmutableList, IterableExtendedIterableView, LinkedList, Matrix, MatrixColumn, MatrixRow, MultiExtendedIterableView, SqlRecord

public interface IterableByExtremumProvider<E>

Author:

Silvan Wyss

Method Summary

Modifier and Type	Method	Description
<C extends Comparable<C>> E	getStoredByMax(Function<E,C> comparableMapper)	The time complexity of this method is O(n) if the current IterableByExtremumProvider contains n elements.
<C extends Comparable<C>> E	getStoredByMin(Function<E,C> comparableMapper)	The time complexity of this method is O(n) if the current IterableByExtremumProvider contains n elements.

Method Details

getStoredByMax

<C extends Comparable<C>> E getStoredByMax(Function<E,C> comparableMapper)

The time complexity of this method is O(n) if the current IterableByExtremumProvider contains n elements.

Type Parameters:

C - the type of the Comparables the given comparableMapper maps from the elements of the current IterableByExtremumProvider

Parameters:

comparableMapper -

Returns:

the last (!) element with the biggest Comparable the given comparableMapper maps from the elements of the current IterableByExtremumProvider, ignoring null elements

Throws:

RuntimeException - if the given comparableMapper is null

RuntimeException - if the current IterableByExtremumProvider does not contain a non-null element.

getStoredByMin

<C extends Comparable<C>> E getStoredByMin(Function<E,C> comparableMapper)

The time complexity of this method is O(n) if the current IterableByExtremumProvider contains n elements.

Type Parameters:

C - the type of the Comparables the given comparableMapper maps from the elements of the current IterableByExtremumProvider

Parameters:

comparableMapper -

Returns:

the first (!) element with the smallest Comparable the given comparableMapper maps from the elements of the current IterableByExtremumProvider, ignoring null elements

Throws:

RuntimeException - if the given comparableMapper is null

RuntimeException - if the current IterableByExtremumProvider does not contain a non-null element.