common:collections/com.tomtom.sdk.common.collections

Package com.tomtom.sdk.common.collections

Functions

fun <E : Any> MutableCollection<E>.addOrThrow(element: E, lazyMessage: () -> Any = { "Element has already been added" })

Adds element to MutableCollection if it does not contain it yet. Throws an IllegalArgumentException with the result of calling lazyMessage if the collections already contains the element.

binaryFindFirst

fun <T> List<T>.binaryFindFirst(predicate: (T) -> Boolean): T?

Searches this list for the first element matching the given predicate using the binary search algorithm. The list is expected to be sorted. Otherwise, the result is undefined.

binaryFindLast

fun <T> List<T>.binaryFindLast(predicate: (T) -> Boolean): T?

Searches this list for the last element matching the given predicate using the binary search algorithm. The list is expected to be sorted. Otherwise, the result is undefined.

forEachNext

fun <E> Iterator<E>.forEachNext(action: (element: E) -> Unit)

This is an equivalent of java.util.Iterator.forEachRemaining, but is named differently to avoid the naming clash. The Java's implementation cannot be used due to the minimum API level restrictions.