Compukters Core/kotlin.collections/List

List

interface List<out T> : Collection<T> (source)

A read-only ordered collection with zero-based indexed access.

Lists may contain duplicate elements. Read-only access does not make the underlying object immutable; aliases of ArrayList observe its mutations. Nullable element types may store null.

Type Parameters

T

element type.

See also

Inheritors

Properties

abstract val size: Int

Number of elements in this collection.

Functions

abstract fun addAll(p0: Collection<out T?>?): Boolean

abstract fun addAll(p0: Int, p1: Collection<out T?>?): Boolean

inline fun <T> Iterable<T>.all(predicate: (T) -> Boolean): Boolean

Returns true when every element matches predicate.

inline fun <T> Iterable<T>.any(predicate: (T) -> Boolean): Boolean

Returns true when at least one element matches predicate.

fun <T> Iterable<T>.asSequence(): Sequence<T>

Borrows this iterable as a lazy sequence without traversing or copying it. Each traversal requests a new source iterator; later mutations and invalidation follow the iterable's own contract. Wrappers and iterators use ordinary managed heap quotas.

abstract operator fun contains(p0: T?): Boolean

Checks whether this collection contains an element equal to element.

operator fun <T> Iterable<T>.contains(element: T): Boolean

Checks whether this iterable has an element equal to element.

abstract fun containsAll(p0: Collection<*>?): Boolean

inline fun <T> Iterable<T>.filter(predicate: (T) -> Boolean): List<T>

Returns a list containing elements matching predicate, in their original iteration order.

fun <T : Any> Iterable<T?>.filterNotNull(): List<T>

Returns a list of non-null elements in their original iteration order.

inline fun <T, C : MutableCollection<in T>> Iterable<T>.filterTo(destination: C, predicate: (T) -> Boolean): C

Appends matching elements to destination in iteration order.

inline fun <T> Iterable<T>.find(predicate: (T) -> Boolean): T?

Returns the first matching element, or null when no element matches predicate.

fun <T> Iterable<T>.first(): T

Returns the first element, throwing NoSuchElementException when empty.

inline fun <T> Iterable<T>.first(predicate: (T) -> Boolean): T

Returns the first matching element, throwing NoSuchElementException when no element matches.

fun <T> Iterable<T>.firstOrNull(): T?

Returns the first element, or null when this iterable is empty.

fun <T> List<T>.firstOrNull(): T?

Returns the first element, or null when this list is empty.

inline fun <T> Iterable<T>.firstOrNull(predicate: (T) -> Boolean): T?

Returns the first matching element, or null when no element matches predicate.

inline fun <T, R> Iterable<T>.fold(initial: R, operation: (R, T) -> R): R

Accumulates elements in iteration order.

inline fun <T> Iterable<T>.forEach(action: (T) -> Unit)

Calls action for each element in iteration order.

inline fun <T> Iterable<T>.forEachIndexed(action: (Int, T) -> Unit)

Calls action for each element and its zero-based index in iteration order.

abstract operator fun get(index: Int): T

Returns the element at index.

fun <T> List<T>.getOrNull(index: Int): T?

Returns the element at index, or null when the index is outside this list.

abstract fun indexOf(element: T): Int

Returns the index of the first element equal to element.

fun <T> Iterable<T>.indexOf(element: T): Int

Returns the index of the first equal element, or -1 when no element matches.

abstract fun isEmpty(): Boolean

Checks whether this collection has no elements.

fun <T> Collection<T>.isNotEmpty(): Boolean

Checks whether this collection contains at least one element.

abstract operator fun iterator(): Iterator<T>

Returns an iterator over this iterable's elements.

abstract fun lastIndexOf(element: T): Int

Returns the index of the last element equal to element.

fun <T> Iterable<T>.lastIndexOf(element: T): Int

Returns the index of the last equal element, or -1 when no element matches.

fun <T> Iterable<T>.lastOrNull(): T?

Returns the last element, or null when this iterable is empty.

fun <T> List<T>.lastOrNull(): T?

Returns the last element, or null when this list is empty.

inline fun <T> Iterable<T>.lastOrNull(predicate: (T) -> Boolean): T?

Returns the last matching element after traversing this iterable in iteration order.

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

Returns the last element satisfying predicate, or null when no element matches.

abstract fun listIterator(): ListIterator<T?>?

abstract fun listIterator(p0: Int): ListIterator<T?>?

inline fun <T, R> Collection<T>.map(transform: (T) -> R): List<R>

inline fun <T, R> Iterable<T>.map(transform: (T) -> R): List<R>

Returns a list containing transform applied once to each element in iteration order.

inline fun <T, R : Any> Iterable<T>.mapNotNull(transform: (T) -> R?): List<R>

Applies transform once per element in iteration order and retains only non-null results.

inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo(destination: C, transform: (T) -> R?): C

Appends non-null transformed elements to destination in iteration order.

inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapTo(destination: C, transform: (T) -> R): C

Appends transformed elements to destination in iteration order.

inline fun <T> Iterable<T>.none(predicate: (T) -> Boolean): Boolean

Returns true when no element matches predicate.

abstract fun removeAll(p0: Collection<*>?): Boolean

abstract fun retainAll(p0: Collection<*>?): Boolean

abstract fun subList(p0: Int, p1: Int): List<T?>?