Spec-Zone.ru › Kotlin 2

AbstractMutableList

kotlin-stdlib/kotlin.collections/AbstractMutableList

Требования к платформе и версии: Common (1.0)

expect abstract class AbstractMutableList<E> : MutableList<E> 

Предоставляет базовую реализацию интерфейса MutableList.

Параметры типа

E

тип элементов, содержащихся в списке. Список инвариантен относительно типа своих элементов.

Наследники

ArrayDeque

Требования к платформе и версии: JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual abstract class AbstractMutableList<E> : AbstractMutableCollection<E> , MutableList<E> 

Предоставляет базовую реализацию интерфейса MutableList.

Параметры типа

E

тип элементов, содержащихся в списке. Список инвариантен относительно типа своих элементов.

Наследники

ArrayList

Требования к платформе и версии: JVM (1.1)

actual abstract class AbstractMutableList<E> : MutableList<E> , AbstractList<E> 

Предоставляет базовую реализацию интерфейса MutableList.

Параметры типа

E

тип элементов, содержащихся в списке. Список инвариантен относительно типа своих элементов.

Конструкторы

AbstractMutableList
protected expect constructor()

Свойства

indices

Требования к платформе и версии: Common (1.0)

val Collection<*>.indices: IntRange

Возвращает IntRange допустимых индексов этой коллекции.

isEmpty

Требования к платформе и версии: JVM (1.1)

open override val isEmpty: Boolean
lastIndex

Требования к платформе и версии: Common (1.0)

val <T> List<T>.lastIndex: Int

Возвращает индекс последнего элемента списка или -1, если список пуст.

modCount

Требования к платформе и версии: Common (2.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

protected expect var modCount: Int

Количество структурных изменений этого списка.

Требования к платформе и версии: JVM (1.1)

protected var modCount: Int
size

Требования к платформе и версии: Common (1.0), JVM (1.1)

expect abstract override val size: Int

Возвращает размер коллекции.

Требования к платформе и версии: JS (1.1)

abstract override val size: Int

Возвращает размер коллекции.

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual abstract val size: Int

Возвращает размер коллекции.

Функции

add

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
expect open override fun add(element: E): Boolean

Добавляет указанный элемент в конец этого списка.

expect abstract fun add(index: Int, element: E)

Вставляет элемент в список по указанному index.

Требования к платформе и версии: JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

@IgnorableReturnValue
actual open override fun add(element: E): Boolean

Добавляет указанный элемент в конец этого списка.

abstract override fun add(index: Int, element: E)

Вставляет элемент в список по указанному index.

Требования к платформе и версии: JVM (1.1)

abstract override fun add(index: Int, element: E)

Вставляет элемент в список по указанному index.

@IgnorableReturnValue
actual open override fun add(element: E): Boolean

Добавляет указанный элемент в конец этого списка.

addAll

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
expect open override fun addAll(elements: Collection<E>): Boolean

Добавляет все элементы указанной коллекции в конец этого списка.

@IgnorableReturnValue
expect open override fun addAll(index: Int, elements: Collection<E>): Boolean

Вставляет все elements указанной коллекции в этот список по указанному index.

Требования к платформе и версии: JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

@IgnorableReturnValue
actual open override fun addAll(elements: Collection<E>): Boolean

Добавляет все элементы указанной коллекции в эту коллекцию.

@IgnorableReturnValue
actual open override fun addAll(index: Int, elements: Collection<E>): Boolean

Вставляет все elements указанной коллекции в этот список по указанному index.

Требования к платформе и версии: JVM (1.1)

@IgnorableReturnValue
actual open override fun addAll(elements: Collection<E>): Boolean

Добавляет все элементы указанной коллекции в конец этого списка.

@IgnorableReturnValue
actual open fun addAll(index: Int, elements: Collection<E>): Boolean

Вставляет все elements указанной коллекции в этот список по указанному index.

addAll

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
fun <T> MutableCollection<in T>.addAll(elements: Array<out T>): Boolean

Добавляет все элементы указанного массива elements в эту MutableCollection.

@IgnorableReturnValue
fun <T> MutableCollection<in T>.addAll(elements: Iterable<T>): Boolean

Добавляет все элементы указанной коллекции elements в эту MutableCollection.

@IgnorableReturnValue
fun <T> MutableCollection<in T>.addAll(elements: Sequence<T>): Boolean

Добавляет все элементы указанной последовательности elements в эту MutableCollection.

all

Требования к платформе и версии: Common (1.0)

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

Возвращает true, если все элементы соответствуют заданному predicate.

allDistinct

Требования к платформе и версии: Common (2.4)

@ExperimentalStdlibApi
fun <T> Iterable<T>.allDistinct(): Boolean

Возвращает true, если все элементы коллекции отличаются друг от друга, то есть никакие два элемента не равны.

allDistinctBy

Требования к платформе и версии: Common (2.4)

@ExperimentalStdlibApi
inline fun <T, K> Iterable<T>.allDistinctBy(selector: (T) -> K): Boolean

Возвращает true, если все значения, полученные при применении функции selector к элементам коллекции, отличаются друг от друга.

allEqual

Требования к платформе и версии: Common (2.4)

@ExperimentalStdlibApi
fun <T> Iterable<T>.allEqual(): Boolean

Возвращает true, если все элементы коллекции равны друг другу.

allEqualBy

Требования к платформе и версии: Common (2.4)

@ExperimentalStdlibApi
inline fun <T, K> Iterable<T>.allEqualBy(selector: (T) -> K): Boolean

Возвращает true, если все элементы коллекции дают одно и то же значение, полученное с помощью заданной функции selector.

any

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.any(): Boolean

Возвращает true, если коллекция содержит хотя бы один элемент.

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

Возвращает true, если хотя бы один элемент соответствует заданному predicate.

asIterable

Требования к платформе и версии: Common (1.0)

inline fun <T> Iterable<T>.asIterable(): Iterable<T>

Возвращает эту коллекцию как Iterable.

asJsArrayView

Требования к платформе и версии: JS (2.0)

@ExperimentalJsExport
@ExperimentalJsCollectionsApi
open fun asJsArrayView(): JsArray<E>

Возвращает представление с методами JsArray, позволяющими использовать его в JavaScript как обычный массив. Структурные изменения базового списка синхронизируются с представлением, и наоборот.

asJsReadonlyArrayView

Требования к платформе и версии: JS (2.0)

@ExperimentalJsExport
@ExperimentalJsCollectionsApi
open fun asJsReadonlyArrayView(): JsReadonlyArray<E>

Возвращает представление с методами JsReadonlyArray, позволяющими использовать его в JavaScript как обычный массив только для чтения. Структурные изменения базового списка синхронизируются с представлением.

asReversed

Требования к платформе и версии: Common (1.0)

fun <T> List<T>.asReversed(): List<T>

Возвращает перевёрнутое представление исходного списка List только для чтения. Все изменения исходного списка отражаются в перевёрнутом представлении.

@JvmName(name = "asReversedMutable")
fun <T> MutableList<T>.asReversed(): MutableList<T>

Возвращает перевёрнутое изменяемое представление исходного изменяемого списка List. Все изменения исходного списка отражаются в перевёрнутом представлении, и наоборот.

asSequence

Требования к платформе и версии: Common (1.0)

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

Создаёт экземпляр Sequence, оборачивающий исходную коллекцию и возвращающий её элементы при переборе.

associate

Требования к платформе и версии: Common (1.0)

inline fun <T, K, V> Iterable<T>.associate(transform: (T) -> Pair<K, V>): Map<K, V>

Возвращает Map, содержащую пары ключ-значение, созданные функцией transform, применённой к элементам указанной коллекции.

associateBy

Требования к платформе и версии: Common (1.0)

inline fun <T, K> Iterable<T>.associateBy(keySelector: (T) -> K): Map<K, T>

Возвращает Map, содержащую элементы указанной коллекции, индексированные ключами, возвращаемыми функцией keySelector, применённой к каждому элементу.

inline fun <T, K, V> Iterable<T>.associateBy(keySelector: (T) -> K, valueTransform: (T) -> V): Map<K, V>

Возвращает Map, содержащую значения, предоставленные функцией valueTransform и индексированные ключами, предоставленными функцией keySelector, применёнными к элементам указанной коллекции.

associateByTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <T, K, M : MutableMap<in K, in T>> Iterable<T>.associateByTo(destination: M, keySelector: (T) -> K): M

Заполняет изменяемую карту destination парами ключ-значение и возвращает её; ключ задаётся функцией keySelector, применённой к каждому элементу указанной коллекции, а значением является сам элемент.

@IgnorableReturnValue
inline fun <T, K, V, M : MutableMap<in K, in V>> Iterable<T>.associateByTo(destination: M, keySelector: (T) -> K, valueTransform: (T) -> V): M

Заполняет изменяемую карту destination парами ключ-значение и возвращает её; ключ задаётся функцией keySelector, а значение — функцией valueTransform, применёнными к элементам указанной коллекции.

associateTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <T, K, V, M : MutableMap<in K, in V>> Iterable<T>.associateTo(destination: M, transform: (T) -> Pair<K, V>): M

Заполняет изменяемую карту destination парами ключ-значение, предоставленными функцией transform, применённой к каждому элементу указанной коллекции, и возвращает её.

associateWith

Требования к платформе и версии: Common (1.3)

inline fun <K, V> Iterable<K>.associateWith(valueSelector: (K) -> V): Map<K, V>

Возвращает Map, в которой ключами являются элементы указанной коллекции, а значения создаются функцией valueSelector, применённой к каждому элементу.

associateWithTo

Требования к платформе и версии: Common (1.3)

@IgnorableReturnValue
inline fun <K, V, M : MutableMap<in K, in V>> Iterable<K>.associateWithTo(destination: M, valueSelector: (K) -> V): M

Заполняет изменяемую карту destination парами ключ-значение для каждого элемента указанной коллекции и возвращает её; ключом является сам элемент, а значение предоставляется функцией valueSelector, применённой к этому ключу.

average

Требования к платформе и версии: Common (1.0)

@JvmName(name = "averageOfByte")
fun Iterable<Byte>.average(): Double
@JvmName(name = "averageOfDouble")
fun Iterable<Double>.average(): Double
@JvmName(name = "averageOfFloat")
fun Iterable<Float>.average(): Double
@JvmName(name = "averageOfInt")
fun Iterable<Int>.average(): Double
@JvmName(name = "averageOfLong")
fun Iterable<Long>.average(): Double
@JvmName(name = "averageOfShort")
fun Iterable<Short>.average(): Double

Возвращает среднее значение элементов коллекции.

binarySearch

Требования к платформе и версии: Common (1.0)

fun <T> List<T>.binarySearch(fromIndex: Int = 0, toIndex: Int = size, comparison: (T) -> Int): Int

Выполняет двоичный поиск элемента в этом списке или его диапазоне; для искомого элемента заданная функция comparison должна возвращать ноль.

fun <T : Comparable<T>> List<T?>.binarySearch(element: T?, fromIndex: Int = 0, toIndex: Int = size): Int

Выполняет двоичный поиск указанного element в этом списке или его диапазоне. Предполагается, что список отсортирован по возрастанию в соответствии с естественным порядком Comparable его элементов; в противном случае результат не определён.

fun <T> List<T>.binarySearch(element: T, comparator: Comparator<in T>, fromIndex: Int = 0, toIndex: Int = size): Int

Выполняет двоичный поиск указанного element в этом списке или его диапазоне. Предполагается, что список отсортирован по возрастанию в соответствии с заданным comparator; в противном случае результат не определён.

binarySearchBy

Требования к платформе и версии: Common (1.0)

inline fun <T, K : Comparable<K>> List<T>.binarySearchBy(key: K?, fromIndex: Int = 0, toIndex: Int = size, crossinline selector: (T) -> K?): Int

Выполняет двоичный поиск в этом списке или его диапазоне элемента, ключ которого, возвращаемый указанной функцией selector, равен заданному значению key. Предполагается, что список отсортирован по возрастанию в соответствии с естественным порядком Comparable ключей его элементов; в противном случае результат не определён.

chunked

Требования к платформе и версии: Common (1.2)

fun <T> Iterable<T>.chunked(size: Int): List<List<T>>

Разбивает эту коллекцию на список списков, каждый из которых не превышает заданный size.

fun <T, R> Iterable<T>.chunked(size: Int, transform: (List<T>) -> R): List<R>

Разбивает эту коллекцию на несколько списков, каждый из которых не превышает заданный size, и применяет к каждому из них заданную функцию transform.

clear

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect open override fun clear()

Удаляет все элементы из этой коллекции.

Требования к платформе и версии: JVM (1.1)

actual open override fun clear()

Удаляет все элементы из этой коллекции.

component1

Требования к платформе и версии: Common (1.0)

inline operator fun <T> List<T>.component1(): T

Возвращает 1-й элемент списка.

component2

Требования к платформе и версии: Common (1.0)

inline operator fun <T> List<T>.component2(): T

Возвращает 2-й элемент списка.

component3

Требования к платформе и версии: Common (1.0)

inline operator fun <T> List<T>.component3(): T

Возвращает 3-й элемент списка.

component4

Требования к платформе и версии: Common (1.0)

inline operator fun <T> List<T>.component4(): T

Возвращает 4-й элемент списка.

component5

Требования к платформе и версии: Common (1.0)

inline operator fun <T> List<T>.component5(): T

Возвращает 5-й элемент списка.

contains

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect open operator override fun contains(element: E): Boolean

Проверяет, содержится ли указанный элемент в этой коллекции.

Требования к платформе и версии: JVM (1.1)

actual open operator override fun contains(element: E): Boolean

Проверяет, содержится ли указанный элемент в этой коллекции.

contains

Требования к платформе и версии: Common (1.0)

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

Возвращает true, если в коллекции найден element.

containsAll

Требования к платформе и версии: Common (1.0)

expect open override fun containsAll(elements: Collection<E>): Boolean

Проверяет, содержатся ли все элементы указанной коллекции в этой коллекции.

Требования к платформе и версии: JS (1.1)

open override fun containsAll(elements: Collection<E>): Boolean

Проверяет, содержатся ли все элементы указанной коллекции в этой коллекции.

Требования к платформе и версии: JVM (1.1)

actual open override fun containsAll(elements: Collection<E>): Boolean

Проверяет, содержатся ли все элементы указанной коллекции в этой коллекции.

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual open fun containsAll(elements: Collection<E>): Boolean

Проверяет, содержатся ли все элементы указанной коллекции в этой коллекции.

containsAll

Требования к платформе и версии: Common (1.0)

inline fun <T> Collection<T>.containsAll(elements: Collection<T>): Boolean

Проверяет, содержатся ли все элементы указанной коллекции в этой коллекции.

count

Требования к платформе и версии: Common (1.0)

inline fun <T> Collection<T>.count(): Int
fun <T> Iterable<T>.count(): Int

Возвращает количество элементов в этой коллекции.

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

Возвращает количество элементов, соответствующих заданному predicate.

distinct

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.distinct(): List<T>

Возвращает список, содержащий только уникальные элементы указанной коллекции.

distinctBy

Требования к платформе и версии: Common (1.0)

inline fun <T, K> Iterable<T>.distinctBy(selector: (T) -> K): List<T>

Возвращает список, содержащий только элементы указанной коллекции с уникальными ключами, возвращаемыми заданной функцией selector.

drop

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.drop(n: Int): List<T>

Возвращает список, содержащий все элементы, кроме первых n элементов.

dropLast

Требования к платформе и версии: Common (1.0)

fun <T> List<T>.dropLast(n: Int): List<T>

Возвращает список, содержащий все элементы, кроме последних n элементов.

dropLastWhile

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий все элементы, кроме последних элементов, соответствующих заданному predicate.

dropWhile

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий все элементы, кроме первых элементов, соответствующих заданному predicate.

elementAt

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.elementAt(index: Int): T

Возвращает элемент по заданному индексу или выбрасывает исключение IndexOutOfBoundsException, если индекс выходит за границы этой коллекции.

inline fun <T> List<T>.elementAt(index: Int): T

Возвращает элемент по заданному индексу или выбрасывает исключение IndexOutOfBoundsException, если индекс выходит за границы этого списка.

elementAtOrElse

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.elementAtOrElse(index: Int, defaultValue: (Int) -> T): T

Возвращает элемент по заданному индексу или результат вызова функции defaultValue, если индекс выходит за границы этой коллекции.

inline fun <T> List<T>.elementAtOrElse(index: Int, defaultValue: (Int) -> T): T

Возвращает элемент по заданному индексу или результат вызова функции defaultValue, если индекс выходит за границы этого списка.

elementAtOrNull

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.elementAtOrNull(index: Int): T?

Возвращает элемент по заданному индексу или null, если индекс выходит за границы этой коллекции.

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

Возвращает элемент по заданному индексу или null, если индекс выходит за границы этого списка.

equals

Требования к платформе и версии: JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

open operator override fun equals(other: Any?): Boolean

Проверяет, являются ли два указанных списка структурно равными.

fill

Требования к платформе и версии: Common (1.2), JS (1.2), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> MutableList<T>.fill(value: T)

Заполняет список заданным значением.

Требования к платформе и версии: JVM (1.2)

actual inline fun <T> MutableList<T>.fill(value: T)

Заполняет список заданным значением.

filter

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий только элементы, удовлетворяющие заданному предикату.

filterIndexed

Требования к платформе и версии: Common (1.0)

inline fun <T> Iterable<T>.filterIndexed(predicate: (index: Int, T) -> Boolean): List<T>

Возвращает список, содержащий только элементы, удовлетворяющие заданному предикату.

filterIndexedTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <T, C : MutableCollection<in T>> Iterable<T>.filterIndexedTo(destination: C, predicate: (index: Int, T) -> Boolean): C

Добавляет все элементы, удовлетворяющие заданному предикату, в указанное назначение.

filterIsInstance

Требования к платформе и версии: Common (1.0)

inline fun <R> Iterable<*>.filterIsInstance(): List<R>

Возвращает список, содержащий все элементы, являющиеся экземплярами указанного параметра типа R.

Требования к платформе и версии: JVM (1.0)

fun <R> Iterable<*>.filterIsInstance(klass: Class<R>): List<R>

Возвращает список, содержащий все элементы, являющиеся экземплярами указанного класса.

filterIsInstanceTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <R, C : MutableCollection<in R>> Iterable<*>.filterIsInstanceTo(destination: C): C

Добавляет все элементы, являющиеся экземплярами указанного параметра типа R, в заданное назначение.

Требования к платформе и версии: JVM (1.0)

@IgnorableReturnValue
fun <C : MutableCollection<in R>, R> Iterable<*>.filterIsInstanceTo(destination: C, klass: Class<R>): C

Добавляет все элементы, являющиеся экземплярами указанного класса, в заданное назначение.

filterNot

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий все элементы, не удовлетворяющие заданному предикату.

filterNotNull

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий все элементы, которые не являются null.

filterNotNullTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
fun <C : MutableCollection<in T>, T : Any> Iterable<T?>.filterNotNullTo(destination: C): C

Добавляет все элементы, которые не являются null, в заданное назначение.

filterNotTo

Требования к платформе и версии: Common (1.0)

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

Добавляет все элементы, не удовлетворяющие заданному предикату, в заданное назначение.

filterTo

Требования к платформе и версии: Common (1.0)

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

Добавляет все элементы, удовлетворяющие заданному предикату, в заданное назначение.

find

Требования к платформе и версии: Common (1.0)

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

Возвращает первый элемент, удовлетворяющий заданному предикату, или null, если такой элемент не найден.

findLast

Требования к платформе и версии: Common (1.0)

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

Возвращает последний элемент, удовлетворяющий заданному предикату, или null, если такой элемент не найден.

first

Требования к платформе и версии: Common (1.0)

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

Возвращает первый элемент.

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

Возвращает первый элемент, удовлетворяющий заданному предикату.

firstNotNullOf

Требования к платформе и версии: Common (1.5)

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

Возвращает первое ненулевое значение, полученное функцией transform, применённой к элементам этой коллекции в порядке итерации, или выбрасывает NoSuchElementException, если ненулевое значение не получено.

firstNotNullOfOrNull

Требования к платформе и версии: Common (1.5)

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

Возвращает первое ненулевое значение, полученное функцией transform, применённой к элементам этой коллекции в порядке итерации, или null, если ненулевое значение не получено.

firstOrNull

Требования к платформе и версии: Common (1.0)

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

Возвращает первый элемент или null, если коллекция пуста.

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

Возвращает первый элемент или null, если список пуст.

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

Возвращает первый элемент, удовлетворяющий заданному предикату, или null, если элемент не найден.

flatMap

Требования к платформе и версии: Common (1.0)

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

Возвращает единый список всех элементов, полученных из результатов вызова функции transform для каждого элемента исходной коллекции.

@JvmName(name = "flatMapSequence")
inline fun <T, R> Iterable<T>.flatMap(transform: (T) -> Sequence<R>): List<R>

Возвращает единый список всех элементов, полученных из результатов вызова функции transform для каждого элемента исходной коллекции.

flatMapIndexed

Требования к платформе и версии: Common (1.4)

@JvmName(name = "flatMapIndexedIterable")
inline fun <T, R> Iterable<T>.flatMapIndexed(transform: (index: Int, T) -> Iterable<R>): List<R>
@JvmName(name = "flatMapIndexedSequence")
inline fun <T, R> Iterable<T>.flatMapIndexed(transform: (index: Int, T) -> Sequence<R>): List<R>

Возвращает единый список всех элементов, полученных из результатов вызова функции transform для каждого элемента исходной коллекции и его индекса.

flatMapIndexedTo

Требования к платформе и версии: Common (1.4)

@JvmName(name = "flatMapIndexedIterableTo")
@IgnorableReturnValue
inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapIndexedTo(destination: C, transform: (index: Int, T) -> Iterable<R>): C
@JvmName(name = "flatMapIndexedSequenceTo")
@IgnorableReturnValue
inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapIndexedTo(destination: C, transform: (index: Int, T) -> Sequence<R>): C

Добавляет все элементы, полученные из результатов вызова функции transform для каждого элемента исходной коллекции и его индекса, в указанное назначение.

flatMapTo

Требования к платформе и версии: Common (1.0)

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

Добавляет все элементы, полученные из результатов вызова функции transform для каждого элемента исходной коллекции, в указанное назначение.

@JvmName(name = "flatMapSequenceTo")
@IgnorableReturnValue
inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapTo(destination: C, transform: (T) -> Sequence<R>): C

Добавляет все элементы, полученные из результатов вызова функции transform для каждого элемента исходной коллекции, в указанное назначение.

flatten

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<Iterable<T>>.flatten(): List<T>

Возвращает единый список всех элементов всех коллекций, входящих в заданную коллекцию.

fold

Требования к платформе и версии: Common (1.0)

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

Накапливает значение, начиная с начального значения и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу.

foldIndexed

Требования к платформе и версии: Common (1.0)

inline fun <T, R> Iterable<T>.foldIndexed(initial: R, operation: (index: Int, acc: R, T) -> R): R

Накапливает значение, начиная с начального значения и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу с его индексом в исходной коллекции.

foldRight

Требования к платформе и версии: Common (1.0)

inline fun <T, R> List<T>.foldRight(initial: R, operation: (T, acc: R) -> R): R

Накапливает значение, начиная с начального значения и применяя операцию справа налево к каждому элементу и текущему значению аккумулятора.

foldRightIndexed

Требования к платформе и версии: Common (1.0)

inline fun <T, R> List<T>.foldRightIndexed(initial: R, operation: (index: Int, T, acc: R) -> R): R

Накапливает значение, начиная с начального значения и применяя операцию справа налево к каждому элементу с его индексом в исходном списке и текущему значению аккумулятора.

forEach

Требования к платформе и версии: Common (1.0)

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

Выполняет заданное действие для каждого элемента.

forEachIndexed

Требования к платформе и версии: Common (1.0)

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

Выполняет заданное действие для каждого элемента, передавая вместе с элементом его порядковый индекс.

get

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect abstract operator fun get(index: Int): E

Возвращает элемент списка с указанным индексом.

getOrElse

Требования к платформе и версии: Common (1.0)

inline fun <T> List<T>.getOrElse(index: Int, defaultValue: (Int) -> T): T

Возвращает элемент по заданному индексу или результат вызова функции defaultValue, если индекс выходит за границы этого списка.

getOrNull

Требования к платформе и версии: Common (1.0)

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

Возвращает элемент по заданному индексу или null, если индекс выходит за границы этого списка.

groupBy

Требования к платформе и версии: Common (1.0)

inline fun <T, K> Iterable<T>.groupBy(keySelector: (T) -> K): Map<K, List<T>>

Группирует элементы исходной коллекции по ключу, возвращаемому функцией keySelector, применённой к каждому элементу, и возвращает карту, в которой каждому ключу группы соответствует список элементов.

inline fun <T, K, V> Iterable<T>.groupBy(keySelector: (T) -> K, valueTransform: (T) -> V): Map<K, List<V>>

Группирует значения, возвращаемые функцией valueTransform, применённой к каждому элементу исходной коллекции, по ключу, возвращаемому функцией keySelector, применённой к элементу, и возвращает карту, в которой каждому ключу группы соответствует список значений.

groupByTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <T, K, M : MutableMap<in K, MutableList<T>>> Iterable<T>.groupByTo(destination: M, keySelector: (T) -> K): M

Группирует элементы исходной коллекции по ключу, возвращаемому функцией keySelector, применённой к каждому элементу, и добавляет в карту назначения каждую группу, связывая её ключ со списком соответствующих элементов.

@IgnorableReturnValue
inline fun <T, K, V, M : MutableMap<in K, MutableList<V>>> Iterable<T>.groupByTo(destination: M, keySelector: (T) -> K, valueTransform: (T) -> V): M

Группирует значения, возвращаемые функцией valueTransform, применённой к каждому элементу исходной коллекции, по ключу, возвращаемому функцией keySelector, применённой к элементу, и добавляет в карту назначения каждую группу, связывая её ключ со списком соответствующих значений.

groupingBy

Требования к платформе и версии: Common (1.1)

inline fun <T, K> Iterable<T>.groupingBy(crossinline keySelector: (T) -> K): Grouping<T, K>

Создаёт источник Grouping из коллекции для последующего использования с одной из операций группировки и свёртки, применяя указанную функцию keySelector для извлечения ключа каждого элемента.

hashCode

Требования к платформе и версии: JS (1.1)

open override fun hashCode(): Int

Возвращает хеш-код этого списка.

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

open override fun hashCode(): Int

Возвращает хеш-код объекта.

indexOf

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect open override fun indexOf(element: E): Int

Возвращает индекс первого вхождения указанного элемента в списке или -1, если список не содержит указанный элемент.

Требования к платформе и версии: JVM (1.1)

actual open fun indexOf(element: E): Int

Возвращает индекс первого вхождения указанного элемента в списке или -1, если список не содержит указанный элемент.

indexOf

Требования к платформе и версии: Common (1.0)

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

Возвращает первый индекс элемента или -1, если коллекция не содержит этот элемент.

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

Возвращает первый индекс элемента или -1, если список не содержит этот элемент.

indexOfFirst

Требования к платформе и версии: Common (1.0)

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

Возвращает индекс первого элемента, удовлетворяющего заданному предикату, или -1, если коллекция не содержит такого элемента.

inline fun <T> List<T>.indexOfFirst(predicate: (T) -> Boolean): Int

Возвращает индекс первого элемента, удовлетворяющего заданному предикату, или -1, если список не содержит такого элемента.

indexOfLast

Требования к платформе и версии: Common (1.0)

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

Возвращает индекс последнего элемента, соответствующего заданному предикату, или -1, если коллекция не содержит такого элемента.

inline fun <T> List<T>.indexOfLast(predicate: (T) -> Boolean): Int

Возвращает индекс последнего элемента, соответствующего заданному предикату, или -1, если список не содержит такого элемента.

intersect

Требования к платформе и версии: Common (1.0)

infix fun <T> Iterable<T>.intersect(other: Iterable<T>): Set<T>

Возвращает множество, содержащее элементы этой коллекции, которые также содержатся в указанной другой коллекции.

isEmpty

Требования к платформе и версии: Common (1.0)

expect open override fun isEmpty(): Boolean

Возвращает true, если коллекция пуста (не содержит элементов), и false в противном случае.

Требования к платформе и версии: JS (1.1)

open override fun isEmpty(): Boolean

Возвращает true, если коллекция пуста (не содержит элементов), и false в противном случае.

Требования к платформе и версии: JVM (1.1)

actual open override fun isEmpty(): Boolean

Возвращает true, если коллекция пуста (не содержит элементов), и false в противном случае.

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual open fun isEmpty(): Boolean

Возвращает true, если коллекция пуста (не содержит элементов), и false в противном случае.

isNotEmpty

Требования к платформе и версии: Common (1.0)

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

Возвращает true, если коллекция не пуста.

isNullOrEmpty

Требования к платформе и версии: Common (1.3)

inline fun <T> Collection<T>?.isNullOrEmpty(): Boolean

Возвращает true, если эта nullable-коллекция равна null или пуста.

isSorted

Требования к платформе и версии: Common (2.4)

fun <T : Comparable<T>> Iterable<T>.isSorted(): Boolean

Возвращает true, если каждый элемент коллекции меньше или равен следующему элементу согласно естественному порядку сортировки.

isSortedBy

Требования к платформе и версии: Common (2.4)

inline fun <T, R : Comparable<R>> Iterable<T>.isSortedBy(selector: (T) -> R?): Boolean

Возвращает true, если для каждого элемента коллекции функция селектор возвращает значение, меньшее или равное значению селектора для следующего элемента согласно естественному порядку сортировки значений селектора.

isSortedByDescending

Требования к платформе и версии: Common (2.4)

inline fun <T, R : Comparable<R>> Iterable<T>.isSortedByDescending(selector: (T) -> R?): Boolean

Возвращает true, если для каждого элемента коллекции функция селектор возвращает значение, большее или равное значению селектора для следующего элемента согласно естественному порядку сортировки значений селектора.

isSortedDescending

Требования к платформе и версии: Common (2.4)

fun <T : Comparable<T>> Iterable<T>.isSortedDescending(): Boolean

Возвращает true, если каждый элемент коллекции больше или равен следующему элементу согласно естественному порядку сортировки.

isSortedWith

Требования к платформе и версии: Common (2.4)

fun <T> Iterable<T>.isSortedWith(comparator: Comparator<in T>): Boolean

Возвращает true, если каждый элемент коллекции меньше или равен следующему элементу согласно заданному компаратору.

iterator

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect open operator override fun iterator(): MutableIterator<E>

Возвращает итератор для элементов этого объекта.

Требования к платформе и версии: JVM (1.1)

actual open operator override fun iterator(): MutableIterator<E>

Возвращает итератор для элементов этого объекта.

joinTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
fun <T, A : Appendable> Iterable<T>.joinTo(buffer: A, separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (T) -> CharSequence? = null): A

Добавляет строку из всех элементов, разделённых с помощью разделителя, и использует заданные префикс и постфикс, если они указаны.

joinToString

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.joinToString(separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (T) -> CharSequence? = null): String

Создаёт строку из всех элементов, разделённых с помощью разделителя, и использует заданные префикс и постфикс, если они указаны.

last

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.last(): T
fun <T> List<T>.last(): T

Возвращает последний элемент.

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

Возвращает последний элемент, соответствующий заданному предикату.

lastIndexOf

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect open override fun lastIndexOf(element: E): Int

Возвращает индекс последнего вхождения указанного элемента в списке или -1, если указанный элемент не содержится в списке.

Требования к платформе и версии: JVM (1.1)

actual open fun lastIndexOf(element: E): Int

Возвращает индекс последнего вхождения указанного элемента в списке или -1, если указанный элемент не содержится в списке.

lastIndexOf

Требования к платформе и версии: Common (1.0)

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

Возвращает последний индекс элемента или -1, если коллекция не содержит элемент.

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

Возвращает последний индекс элемента или -1, если список не содержит элемент.

lastOrNull

Требования к платформе и версии: Common (1.0)

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

Возвращает последний элемент или null, если коллекция пуста.

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

Возвращает последний элемент или null, если список пуст.

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

Возвращает последний элемент, соответствующий заданному предикату, или null, если такой элемент не найден.

listIterator

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect open override fun listIterator(): MutableListIterator<E>

Возвращает итератор списка для элементов этого списка (в правильном порядке).

expect open override fun listIterator(index: Int): MutableListIterator<E>

Возвращает итератор списка для элементов этого списка (в правильном порядке), начиная с указанного индекса.

Требования к платформе и версии: JVM (1.1)

actual open override fun listIterator(): MutableListIterator<E>

Возвращает итератор списка для элементов этого списка (в правильном порядке).

actual open override fun listIterator(index: Int): MutableListIterator<E>

Возвращает итератор списка для элементов этого списка (в правильном порядке), начиная с указанного индекса.

map

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу исходной коллекции.

mapIndexed

Требования к платформе и версии: Common (1.0)

inline fun <T, R> Iterable<T>.mapIndexed(transform: (index: Int, T) -> R): List<R>

Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу и его индексу в исходной коллекции.

mapIndexedNotNull

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий только ненулевые результаты применения заданной функции преобразования к каждому элементу и его индексу в исходной коллекции.

mapIndexedNotNullTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapIndexedNotNullTo(destination: C, transform: (index: Int, T) -> R?): C

Применяет заданную функцию преобразования к каждому элементу и его индексу в исходной коллекции и добавляет только ненулевые результаты в указанную целевую коллекцию.

mapIndexedTo

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo(destination: C, transform: (index: Int, T) -> R): C

Применяет заданную функцию преобразования к каждому элементу и его индексу в исходной коллекции и добавляет результаты в указанную целевую коллекцию.

mapNotNull

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий только ненулевые результаты применения заданной функции преобразования к каждому элементу исходной коллекции.

mapNotNullTo

Требования к платформе и версии: Common (1.0)

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

Применяет заданную функцию преобразования к каждому элементу исходной коллекции и добавляет только ненулевые результаты в указанную целевую коллекцию.

mapTo

Требования к платформе и версии: Common (1.0)

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

Применяет заданную функцию преобразования к каждому элементу исходной коллекции и добавляет результаты в указанную целевую коллекцию.

max

Требования к платформе и версии: Common (1.7)

@JvmName(name = "maxOrThrow")
fun <T : Comparable<T>> Iterable<T>.max(): T
@JvmName(name = "maxOrThrow")
fun Iterable<Double>.max(): Double
@JvmName(name = "maxOrThrow")
fun Iterable<Float>.max(): Float

Возвращает наибольший элемент.

Требования к платформе и версии: JVM (1.0)

fun <T : Comparable<T>> Iterable<T>.max(): T?
fun Iterable<Double>.max(): Double?
fun Iterable<Float>.max(): Float?
maxBy

Требования к платформе и версии: Common (1.7)

@JvmName(name = "maxByOrThrow")
inline fun <T, R : Comparable<R>> Iterable<T>.maxBy(selector: (T) -> R): T

Возвращает первый элемент, для которого функция селектор возвращает наибольшее значение.

Требования к платформе и версии: JVM (1.0)

inline fun <T, R : Comparable<R>> Iterable<T>.maxBy(selector: (T) -> R): T?
maxByOrNull

Требования к платформе и версии: Common (1.4)

inline fun <T, R : Comparable<R>> Iterable<T>.maxByOrNull(selector: (T) -> R): T?

Возвращает первый элемент, для которого функция селектор возвращает наибольшее значение, или null, если элементов нет.

maxOf

Требования к платформе и версии: Common (1.4)

inline fun <T, R : Comparable<R>> Iterable<T>.maxOf(selector: (T) -> R): R
inline fun <T> Iterable<T>.maxOf(selector: (T) -> Double): Double
inline fun <T> Iterable<T>.maxOf(selector: (T) -> Float): Float

Возвращает наибольшее значение среди всех значений, полученных при применении функции селектора к каждому элементу коллекции.

maxOfOrNull

Требования к платформе и версии: Common (1.4)

inline fun <T, R : Comparable<R>> Iterable<T>.maxOfOrNull(selector: (T) -> R): R?
inline fun <T> Iterable<T>.maxOfOrNull(selector: (T) -> Double): Double?
inline fun <T> Iterable<T>.maxOfOrNull(selector: (T) -> Float): Float?

Возвращает наибольшее значение среди всех значений, полученных при применении функции селектора к каждому элементу коллекции, или null, если коллекция пуста.

maxOfWith

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.maxOfWith(comparator: Comparator<in R>, selector: (T) -> R): R

Возвращает наибольшее значение согласно заданному компаратору среди всех значений, полученных при применении функции селектора к каждому элементу коллекции.

maxOfWithOrNull

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.maxOfWithOrNull(comparator: Comparator<in R>, selector: (T) -> R): R?

Возвращает наибольшее значение согласно заданному компаратору среди всех значений, полученных при применении функции селектора к каждому элементу коллекции, или null, если коллекция пуста.

maxOrNull

Требования к платформе и версии: Common (1.4)

fun <T : Comparable<T>> Iterable<T>.maxOrNull(): T?
fun Iterable<Double>.maxOrNull(): Double?
fun Iterable<Float>.maxOrNull(): Float?

Возвращает наибольший элемент или null, если коллекция пуста.

maxWith

Требования к платформе и версии: Common (1.7)

@JvmName(name = "maxWithOrThrow")
fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T

Возвращает первый элемент, имеющий наибольшее значение согласно заданному компаратору.

Требования к платформе и версии: JVM (1.0)

fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T?
maxWithOrNull

Требования к платформе и версии: Common (1.4)

fun <T> Iterable<T>.maxWithOrNull(comparator: Comparator<in T>): T?

Возвращает первый элемент, имеющий наибольшее значение согласно заданному компаратору, или null, если элементов нет.

min

Требования к платформе и версии: Common (1.7)

@JvmName(name = "minOrThrow")
fun <T : Comparable<T>> Iterable<T>.min(): T
@JvmName(name = "minOrThrow")
fun Iterable<Double>.min(): Double
@JvmName(name = "minOrThrow")
fun Iterable<Float>.min(): Float

Возвращает наименьший элемент.

Требования к платформе и версии: JVM (1.0)

fun <T : Comparable<T>> Iterable<T>.min(): T?
fun Iterable<Double>.min(): Double?
fun Iterable<Float>.min(): Float?
minBy

Требования к платформе и версии: Common (1.7)

@JvmName(name = "minByOrThrow")
inline fun <T, R : Comparable<R>> Iterable<T>.minBy(selector: (T) -> R): T

Возвращает первый элемент, для которого функция селектор возвращает наименьшее значение.

Требования к платформе и версии: JVM (1.0)

inline fun <T, R : Comparable<R>> Iterable<T>.minBy(selector: (T) -> R): T?
minByOrNull

Требования к платформе и версии: Common (1.4)

inline fun <T, R : Comparable<R>> Iterable<T>.minByOrNull(selector: (T) -> R): T?

Возвращает первый элемент, для которого функция селектор возвращает наименьшее значение, или null, если элементов нет.

minOf

Требования к платформе и версии: Common (1.4)

inline fun <T, R : Comparable<R>> Iterable<T>.minOf(selector: (T) -> R): R
inline fun <T> Iterable<T>.minOf(selector: (T) -> Double): Double
inline fun <T> Iterable<T>.minOf(selector: (T) -> Float): Float

Возвращает наименьшее значение среди всех значений, полученных при применении функции селектора к каждому элементу коллекции.

minOfOrNull

Требования к платформе и версии: Common (1.4)

inline fun <T, R : Comparable<R>> Iterable<T>.minOfOrNull(selector: (T) -> R): R?
inline fun <T> Iterable<T>.minOfOrNull(selector: (T) -> Double): Double?
inline fun <T> Iterable<T>.minOfOrNull(selector: (T) -> Float): Float?

Возвращает наименьшее значение среди всех значений, полученных при применении функции селектора к каждому элементу коллекции, или null, если коллекция пуста.

minOfWith

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.minOfWith(comparator: Comparator<in R>, selector: (T) -> R): R

Возвращает наименьшее значение согласно заданному компаратору среди всех значений, полученных при применении функции селектора к каждому элементу коллекции.

minOfWithOrNull

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.minOfWithOrNull(comparator: Comparator<in R>, selector: (T) -> R): R?

Возвращает наименьшее значение согласно указанному компаратору среди всех значений, полученных при применении функции selector к каждому элементу коллекции, или null, если коллекция пуста.

minOrNull

Требования к платформе и версии: Common (1.4)

fun <T : Comparable<T>> Iterable<T>.minOrNull(): T?
fun Iterable<Double>.minOrNull(): Double?
fun Iterable<Float>.minOrNull(): Float?

Возвращает наименьший элемент или null, если коллекция пуста.

minus

Требования к платформе и версии: Common (1.0)

operator fun <T> Iterable<T>.minus(element: T): List<T>

Возвращает список, содержащий все элементы исходной коллекции, кроме первого вхождения заданного элемента.

operator fun <T> Iterable<T>.minus(elements: Array<out T>): List<T>

Возвращает список, содержащий все элементы исходной коллекции, кроме элементов, содержащихся в заданном массиве elements.

operator fun <T> Iterable<T>.minus(elements: Iterable<T>): List<T>

Возвращает список, содержащий все элементы исходной коллекции, кроме элементов, содержащихся в заданной коллекции elements.

operator fun <T> Iterable<T>.minus(elements: Sequence<T>): List<T>

Возвращает список, содержащий все элементы исходной коллекции, кроме элементов, содержащихся в заданной последовательности elements.

minusAssign

Требования к платформе и версии: Common (1.0)

inline operator fun <T> MutableCollection<in T>.minusAssign(element: T)

Удаляет один экземпляр указанного элемента из этой изменяемой коллекции.

inline operator fun <T> MutableCollection<in T>.minusAssign(elements: Array<T>)

Удаляет все элементы из заданного массива elements из этой изменяемой коллекции.

inline operator fun <T> MutableCollection<in T>.minusAssign(elements: Iterable<T>)

Удаляет все элементы из заданной коллекции elements из этой изменяемой коллекции.

inline operator fun <T> MutableCollection<in T>.minusAssign(elements: Sequence<T>)

Удаляет все элементы из заданной последовательности elements из этой изменяемой коллекции.

minusElement

Требования к платформе и версии: Common (1.0)

inline fun <T> Iterable<T>.minusElement(element: T): List<T>

Возвращает список, содержащий все элементы исходной коллекции, кроме первого вхождения заданного элемента.

minWith

Требования к платформе и версии: Common (1.7)

@JvmName(name = "minWithOrThrow")
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T

Возвращает первый элемент с наименьшим значением согласно указанному компаратору.

Требования к платформе и версии: JVM (1.0)

fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?
minWithOrNull

Требования к платформе и версии: Common (1.4)

fun <T> Iterable<T>.minWithOrNull(comparator: Comparator<in T>): T?

Возвращает первый элемент с наименьшим значением согласно указанному компаратору или null, если элементов нет.

none

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.none(): Boolean

Возвращает true, если коллекция не содержит элементов.

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

Возвращает true, если ни один элемент не соответствует заданному предикату.

orEmpty

Требования к платформе и версии: Common (1.0)

inline fun <T> Collection<T>?.orEmpty(): Collection<T>

Возвращает эту коллекцию, если она не null, а в противном случае — пустой список.

inline fun <T> List<T>?.orEmpty(): List<T>

Возвращает этот список, если он не null, а в противном случае — пустой список.

partition

Требования к платформе и версии: Common (1.0)

inline fun <T> Iterable<T>.partition(predicate: (T) -> Boolean): Pair<List<T>, List<T>>

Разбивает исходную коллекцию на пару списков: первый список содержит элементы, для которых predicate вернул true, а второй список содержит элементы, для которых predicate вернул false.

plus

Требования к платформе и версии: Common (1.0)

operator fun <T> Collection<T>.plus(element: T): List<T>
operator fun <T> Iterable<T>.plus(element: T): List<T>

Возвращает список, содержащий все элементы исходной коллекции, а затем заданный элемент.

operator fun <T> Collection<T>.plus(elements: Array<out T>): List<T>
operator fun <T> Iterable<T>.plus(elements: Array<out T>): List<T>

Возвращает список, содержащий все элементы исходной коллекции, а затем все элементы заданного массива elements.

operator fun <T> Collection<T>.plus(elements: Iterable<T>): List<T>
operator fun <T> Iterable<T>.plus(elements: Iterable<T>): List<T>

Возвращает список, содержащий все элементы исходной коллекции, а затем все элементы заданной коллекции elements.

operator fun <T> Collection<T>.plus(elements: Sequence<T>): List<T>
operator fun <T> Iterable<T>.plus(elements: Sequence<T>): List<T>

Возвращает список, содержащий все элементы исходной коллекции, а затем все элементы заданной последовательности elements.

plusAssign

Требования к платформе и версии: Common (1.0)

inline operator fun <T> MutableCollection<in T>.plusAssign(element: T)

Добавляет указанный элемент в эту изменяемую коллекцию.

inline operator fun <T> MutableCollection<in T>.plusAssign(elements: Array<T>)

Добавляет все элементы заданного массива elements в эту изменяемую коллекцию.

inline operator fun <T> MutableCollection<in T>.plusAssign(elements: Iterable<T>)

Добавляет все элементы заданной коллекции elements в эту изменяемую коллекцию.

inline operator fun <T> MutableCollection<in T>.plusAssign(elements: Sequence<T>)

Добавляет все элементы заданной последовательности elements в эту изменяемую коллекцию.

plusElement

Требования к платформе и версии: Common (1.0)

inline fun <T> Collection<T>.plusElement(element: T): List<T>
inline fun <T> Iterable<T>.plusElement(element: T): List<T>

Возвращает список, содержащий все элементы исходной коллекции, а затем заданный элемент.

random

Требования к платформе и версии: Common (1.3)

inline fun <T> Collection<T>.random(): T

Возвращает случайный элемент из этой коллекции.

fun <T> Collection<T>.random(random: Random): T

Возвращает случайный элемент из этой коллекции, используя указанный источник случайных чисел.

randomOrNull

Требования к платформе и версии: Common (1.4)

inline fun <T> Collection<T>.randomOrNull(): T?

Возвращает случайный элемент из этой коллекции или null, если коллекция пуста.

fun <T> Collection<T>.randomOrNull(random: Random): T?

Возвращает случайный элемент из этой коллекции, используя указанный источник случайных чисел, или null, если коллекция пуста.

reduce

Требования к платформе и версии: Common (1.0)

inline fun <S, T : S> Iterable<T>.reduce(operation: (acc: S, T) -> S): S

Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу.

reduceIndexed

Требования к платформе и версии: Common (1.0)

inline fun <S, T : S> Iterable<T>.reduceIndexed(operation: (index: Int, acc: S, T) -> S): S

Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу с его индексом в исходной коллекции.

reduceIndexedOrNull

Требования к платформе и версии: Common (1.4)

inline fun <S, T : S> Iterable<T>.reduceIndexedOrNull(operation: (index: Int, acc: S, T) -> S): S?

Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу с его индексом в исходной коллекции.

reduceOrNull

Требования к платформе и версии: Common (1.4)

inline fun <S, T : S> Iterable<T>.reduceOrNull(operation: (acc: S, T) -> S): S?

Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению аккумулятора и каждому элементу.

reduceRight

Требования к платформе и версии: Common (1.0)

inline fun <S, T : S> List<T>.reduceRight(operation: (T, acc: S) -> S): S

Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу и текущему значению аккумулятора.

reduceRightIndexed

Требования к платформе и версии: Common (1.0)

inline fun <S, T : S> List<T>.reduceRightIndexed(operation: (index: Int, T, acc: S) -> S): S

Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу с его индексом в исходном списке и текущему значению аккумулятора.

reduceRightIndexedOrNull

Требования к платформе и версии: Common (1.4)

inline fun <S, T : S> List<T>.reduceRightIndexedOrNull(operation: (index: Int, T, acc: S) -> S): S?

Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу с его индексом в исходном списке и текущему значению аккумулятора.

reduceRightOrNull

Требования к платформе и версии: Common (1.4)

inline fun <S, T : S> List<T>.reduceRightOrNull(operation: (T, acc: S) -> S): S?

Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу и текущему значению аккумулятора.

remove

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
expect open override fun remove(element: E): Boolean

Удаляет один экземпляр указанного элемента из этой коллекции, если коллекция его содержит.

Требования к платформе и версии: JS (1.1)

@IgnorableReturnValue
actual open override fun remove(element: E): Boolean

Удаляет один экземпляр указанного элемента из этой коллекции, если коллекция его содержит.

Требования к платформе и версии: JVM (1.1)

@IgnorableReturnValue
actual open override fun remove(element: E): Boolean

Удаляет один экземпляр указанного элемента из этой коллекции, если коллекция его содержит.

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

@IgnorableReturnValue
actual open override fun remove(element: E): Boolean

Удаляет один экземпляр указанного элемента из этой коллекции, если он присутствует.

remove

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
inline fun <T> MutableCollection<out T>.remove(element: T): Boolean

Удаляет один экземпляр указанного элемента из этой коллекции, если он присутствует.

inline fun <T> MutableList<T>.remove(index: Int): T

Удаляет элемент по указанному индексу из этого списка. В Kotlin вместо этого следует использовать функцию MutableList.removeAt.

removeAll

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

@IgnorableReturnValue
expect open override fun removeAll(elements: Collection<E>): Boolean

Удаляет все элементы этой коллекции, которые также содержатся в указанной коллекции.

Требования к платформе и версии: JVM (1.1)

@IgnorableReturnValue
actual open override fun removeAll(elements: Collection<E>): Boolean

Удаляет все элементы этой коллекции, которые также содержатся в указанной коллекции.

removeAll

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
fun <T> MutableCollection<in T>.removeAll(elements: Array<out T>): Boolean

Удаляет из этой MutableCollection все элементы, которые также содержатся в заданном массиве elements.

@IgnorableReturnValue
inline fun <T> MutableCollection<out T>.removeAll(elements: Collection<T>): Boolean

Удаляет все элементы этой коллекции, которые также содержатся в указанной коллекции.

@IgnorableReturnValue
fun <T> MutableCollection<in T>.removeAll(elements: Iterable<T>): Boolean

Удаляет из этой MutableCollection все элементы, которые также содержатся в заданной коллекции elements.

@IgnorableReturnValue
fun <T> MutableCollection<in T>.removeAll(elements: Sequence<T>): Boolean

Удаляет из этой MutableCollection все элементы, которые также содержатся в заданной последовательности elements.

@IgnorableReturnValue
fun <T> MutableIterable<T>.removeAll(predicate: (T) -> Boolean): Boolean

Удаляет из этого MutableIterable все элементы, соответствующие заданному предикату.

@IgnorableReturnValue
fun <T> MutableList<T>.removeAll(predicate: (T) -> Boolean): Boolean

Удаляет из этого MutableList все элементы, соответствующие заданному предикату.

removeAt

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
expect abstract fun removeAt(index: Int): E

Удаляет элемент по указанному индексу из списка.

Требования к платформе и версии: JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

@IgnorableReturnValue
abstract override fun removeAt(index: Int): E

Удаляет элемент по указанному индексу из списка.

Требования к платформе и версии: JVM (1.1)

@IgnorableReturnValue
abstract override fun removeAt(index: Int): E

Удаляет элемент по указанному индексу из списка.

removeFirst

Требования к платформе и версии: Common (1.4)

@IgnorableReturnValue
fun <T> MutableList<T>.removeFirst(): T

Удаляет первый элемент из этого изменяемого списка и возвращает удалённый элемент либо выбрасывает NoSuchElementException, если список пуст.

removeFirstOrNull

Требования к платформе и версии: Common (1.4)

@IgnorableReturnValue
fun <T> MutableList<T>.removeFirstOrNull(): T?

Удаляет первый элемент из этого изменяемого списка и возвращает удалённый элемент либо возвращает null, если список пуст.

removeLast

Требования к платформе и версии: Common (1.4)

@IgnorableReturnValue
fun <T> MutableList<T>.removeLast(): T

Удаляет последний элемент из этого изменяемого списка и возвращает удалённый элемент либо выбрасывает NoSuchElementException, если список пуст.

removeLastOrNull

Требования к платформе и версии: Common (1.4)

@IgnorableReturnValue
fun <T> MutableList<T>.removeLastOrNull(): T?

Удаляет последний элемент из этого изменяемого списка и возвращает удалённый элемент либо возвращает null, если список пуст.

removeRange

Требования к платформе и версии: Common (2.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

protected expect open fun removeRange(fromIndex: Int, toIndex: Int)

Удаляет диапазон элементов из этого списка, начиная с fromIndex и заканчивая перед toIndex.

Требования к платформе и версии: JVM (1.1)

protected open fun removeRange(fromIndex: Int, toIndex: Int)
replaceAll

Требования к платформе и версии: Native (1.3)

@ExperimentalNativeApi
actual fun <T> MutableList<T>.replaceAll(transformation: (T) -> T)

Заменяет каждый элемент списка результатом указанного преобразования.

requireNoNulls

Требования к платформе и версии: Common (1.0)

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

Возвращает исходную коллекцию, содержащую все элементы, отличные от null, и выбрасывает IllegalArgumentException, если в ней есть элементы null.

retainAll

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

@IgnorableReturnValue
expect open override fun retainAll(elements: Collection<E>): Boolean

Оставляет в этой коллекции только элементы, содержащиеся в указанной коллекции.

Требования к платформе и версии: JVM (1.1)

@IgnorableReturnValue
actual open override fun retainAll(elements: Collection<E>): Boolean

Оставляет в этой коллекции только элементы, содержащиеся в указанной коллекции.

retainAll

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
fun <T> MutableCollection<in T>.retainAll(elements: Array<out T>): Boolean

Оставляет в этой MutableCollection только элементы, содержащиеся в заданном массиве elements.

@IgnorableReturnValue
inline fun <T> MutableCollection<out T>.retainAll(elements: Collection<T>): Boolean

Оставляет в этой коллекции только элементы, содержащиеся в указанной коллекции.

@IgnorableReturnValue
fun <T> MutableCollection<in T>.retainAll(elements: Iterable<T>): Boolean

Оставляет в этой MutableCollection только элементы, содержащиеся в заданной коллекции elements.

@IgnorableReturnValue
fun <T> MutableCollection<in T>.retainAll(elements: Sequence<T>): Boolean

Оставляет в этой MutableCollection только элементы, содержащиеся в заданной последовательности elements.

@IgnorableReturnValue
fun <T> MutableIterable<T>.retainAll(predicate: (T) -> Boolean): Boolean

Оставляет в этом MutableIterable только элементы, соответствующие заданному предикату.

@IgnorableReturnValue
fun <T> MutableList<T>.retainAll(predicate: (T) -> Boolean): Boolean

Оставляет в этом MutableList только элементы, соответствующие заданному предикату.

reverse

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> MutableList<T>.reverse()

Изменяет порядок элементов списка на обратный на месте.

reversed

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.reversed(): List<T>

Возвращает список с элементами в обратном порядке.

runningFold

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.runningFold(initial: R, operation: (acc: R, T) -> R): List<R>

Возвращает список, содержащий последовательные значения накопления, полученные применением operation слева направо к каждому элементу и текущему значению аккумулятора, которое начинается со значения initial.

runningFoldIndexed

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.runningFoldIndexed(initial: R, operation: (index: Int, acc: R, T) -> R): List<R>

Возвращает список, содержащий последовательные значения накопления, полученные применением operation слева направо к каждому элементу, его индексу в исходной коллекции и текущему значению аккумулятора, которое начинается со значения initial.

runningReduce

Требования к платформе и версии: Common (1.4)

inline fun <S, T : S> Iterable<T>.runningReduce(operation: (acc: S, T) -> S): List<S>

Возвращает список, содержащий последовательные значения накопления, полученные применением operation слева направо к каждому элементу и текущему значению аккумулятора, которое начинается с первого элемента этой коллекции.

runningReduceIndexed

Требования к платформе и версии: Common (1.4)

inline fun <S, T : S> Iterable<T>.runningReduceIndexed(operation: (index: Int, acc: S, T) -> S): List<S>

Возвращает список, содержащий последовательные значения накопления, полученные применением operation слева направо к каждому элементу, его индексу в исходной коллекции и текущему значению аккумулятора, которое начинается с первого элемента этой коллекции.

scan

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.scan(initial: R, operation: (acc: R, T) -> R): List<R>

Возвращает список, содержащий последовательные значения накопления, полученные применением operation слева направо к каждому элементу и текущему значению аккумулятора, которое начинается со значения initial.

scanIndexed

Требования к платформе и версии: Common (1.4)

inline fun <T, R> Iterable<T>.scanIndexed(initial: R, operation: (index: Int, acc: R, T) -> R): List<R>

Возвращает список, содержащий последовательные значения накопления, полученные применением operation слева направо к каждому элементу, его индексу в исходной коллекции и текущему значению аккумулятора, которое начинается со значения initial.

set

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
expect abstract operator fun set(index: Int, element: E): E

Заменяет элемент в указанной позиции этого списка указанным элементом.

Требования к платформе и версии: JS (1.1), JVM (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

@IgnorableReturnValue
abstract operator override fun set(index: Int, element: E): E

Заменяет элемент в указанной позиции этого списка указанным элементом.

shuffle

Требования к платформе и версии: Common (1.2)

expect fun <T> MutableList<T>.shuffle()

Случайным образом перемешивает элементы этого списка на месте.

fun <T> MutableList<T>.shuffle(random: Random)

Случайным образом перемешивает элементы этого списка на месте, используя указанный экземпляр random в качестве источника случайности.

Требования к платформе и версии: JS (1.2), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun <T> MutableList<T>.shuffle()

Случайным образом перемешивает элементы этого списка на месте.

Требования к платформе и версии: JVM (1.2)

actual inline fun <T> MutableList<T>.shuffle()

Случайным образом перемешивает элементы этого изменяемого списка.

inline fun <T> MutableList<T>.shuffle(random: Random)

Случайным образом перемешивает элементы этого изменяемого списка, используя указанный экземпляр random в качестве источника случайности.

shuffled

Требования к платформе и версии: Common (1.2)

expect fun <T> Iterable<T>.shuffled(): List<T>

Возвращает новый список со случайным образом перемешанными элементами этой коллекции.

fun <T> Iterable<T>.shuffled(random: Random): List<T>

Возвращает новый список со случайным образом перемешанными элементами этого списка, используя указанный экземпляр random в качестве источника случайности.

Требования к платформе и версии: JS (1.2), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun <T> Iterable<T>.shuffled(): List<T>

Возвращает новый список со случайным образом перемешанными элементами этой коллекции.

Требования к платформе и версии: JVM (1.2)

actual fun <T> Iterable<T>.shuffled(): List<T>

Возвращает новый список со случайным образом перемешанными элементами этой коллекции.

fun <T> Iterable<T>.shuffled(random: Random): List<T>

Возвращает новый список со случайным образом перемешанными элементами этого списка, используя указанный экземпляр random в качестве источника случайности.

single

Требования к платформе и версии: Common (1.0)

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

Возвращает единственный элемент или выбрасывает исключение, если коллекция пуста или содержит более одного элемента.

fun <T> List<T>.single(): T

Возвращает единственный элемент или выбрасывает исключение, если список пуст или содержит более одного элемента.

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

Возвращает единственный элемент, соответствующий заданному predicate, или выбрасывает исключение, если соответствующих элементов нет или их больше одного.

singleOrNull

Требования к платформе и версии: Common (1.0)

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

Возвращает единственный элемент или null, если коллекция пуста или содержит более одного элемента.

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

Возвращает единственный элемент или null, если список пуст или содержит более одного элемента.

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

Возвращает единственный элемент, соответствующий заданному predicate, или null, если элемент не найден или найдено более одного элемента.

slice

Требования к платформе и версии: Common (1.0)

fun <T> List<T>.slice(indices: Iterable<Int>): List<T>

Возвращает список, содержащий элементы с указанными indices.

fun <T> List<T>.slice(indices: IntRange): List<T>

Возвращает список, содержащий элементы с индексами из указанного диапазона indices.

sort

Требования к платформе и версии: Common (1.0), JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T : Comparable<T>> MutableList<T>.sort()

Сортирует элементы списка на месте в соответствии с естественным порядком сортировки.

Требования к платформе и версии: JVM (1.0)

actual fun <T : Comparable<T>> MutableList<T>.sort()

Сортирует элементы списка на месте в соответствии с естественным порядком сортировки.

inline fun <T> MutableList<T>.sort(comparator: Comparator<in T>)
inline fun <T> MutableList<T>.sort(comparison: (T, T) -> Int)
sortBy

Требования к платформе и версии: Common (1.0)

inline fun <T, R : Comparable<R>> MutableList<T>.sortBy(crossinline selector: (T) -> R?)

Сортирует элементы списка на месте в соответствии с естественным порядком сортировки значений, возвращаемых указанной функцией selector.

sortByDescending

Требования к платформе и версии: Common (1.0)

inline fun <T, R : Comparable<R>> MutableList<T>.sortByDescending(crossinline selector: (T) -> R?)

Сортирует элементы списка на месте в порядке убывания согласно естественному порядку сортировки значений, возвращаемых указанной функцией selector.

sortDescending

Требования к платформе и версии: Common (1.0)

fun <T : Comparable<T>> MutableList<T>.sortDescending()

Сортирует элементы списка на месте в порядке убывания согласно естественному порядку сортировки.

sorted

Требования к платформе и версии: Common (1.0)

fun <T : Comparable<T>> Iterable<T>.sorted(): List<T>

Возвращает список всех элементов, отсортированных в соответствии с естественным порядком сортировки.

sortedBy

Требования к платформе и версии: Common (1.0)

inline fun <T, R : Comparable<R>> Iterable<T>.sortedBy(crossinline selector: (T) -> R?): List<T>

Возвращает список всех элементов, отсортированных в соответствии с естественным порядком сортировки значений, возвращаемых указанной функцией selector.

sortedByDescending

Требования к платформе и версии: Common (1.0)

inline fun <T, R : Comparable<R>> Iterable<T>.sortedByDescending(crossinline selector: (T) -> R?): List<T>

Возвращает список всех элементов, отсортированных в порядке убывания согласно естественному порядку сортировки значений, возвращаемых указанной функцией selector.

sortedDescending

Требования к платформе и версии: Common (1.0)

fun <T : Comparable<T>> Iterable<T>.sortedDescending(): List<T>

Возвращает список всех элементов, отсортированных в порядке убывания согласно естественному порядку сортировки.

sortedWith

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.sortedWith(comparator: Comparator<in T>): List<T>

Возвращает список всех элементов, отсортированных с помощью указанного comparator.

sortWith

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> MutableList<T>.sortWith(comparator: Comparator<in T>)

Сортирует элементы списка на месте в соответствии с порядком, заданным с помощью comparator.

subList

Требования к платформе и версии: Common (1.0), JS (1.1)

expect open override fun subList(fromIndex: Int, toIndex: Int): MutableList<E>

Возвращает представление части этого списка между указанными fromIndex (включительно) и toIndex (не включая). Возвращённый список основан на этом списке, поэтому изменения в возвращённом списке отражаются в этом списке, и наоборот.

Требования к платформе и версии: JVM (1.1)

actual open override fun subList(fromIndex: Int, toIndex: Int): MutableList<E>

Возвращает представление части этого списка между указанными fromIndex (включительно) и toIndex (не включая). Возвращённый список основан на этом списке, поэтому изменения в возвращённом списке отражаются в этом списке, и наоборот.

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual open override fun subList(fromIndex: Int, toIndex: Int): MutableList<E>

Возвращает представление части этого списка между указанными fromIndex (включительно) и toIndex (не включая). Возвращённый список основан на этом списке, поэтому изменения в возвращённом списке отражаются в этом списке, и наоборот.

subtract

Требования к платформе и версии: Common (1.0)

infix fun <T> Iterable<T>.subtract(other: Iterable<T>): Set<T>

Возвращает множество, содержащее все элементы, которые входят в эту коллекцию, но не входят в указанную коллекцию.

sum

Требования к платформе и версии: Common (1.0)

@JvmName(name = "sumOfByte")
fun Iterable<Byte>.sum(): Int
@JvmName(name = "sumOfDouble")
fun Iterable<Double>.sum(): Double
@JvmName(name = "sumOfFloat")
fun Iterable<Float>.sum(): Float
@JvmName(name = "sumOfInt")
fun Iterable<Int>.sum(): Int
@JvmName(name = "sumOfLong")
fun Iterable<Long>.sum(): Long
@JvmName(name = "sumOfShort")
fun Iterable<Short>.sum(): Int

Возвращает сумму всех элементов коллекции.

@JvmName(name = "sumOfUByte")
fun Iterable<UByte>.sum(): UInt
@JvmName(name = "sumOfUInt")
fun Iterable<UInt>.sum(): UInt
@JvmName(name = "sumOfULong")
fun Iterable<ULong>.sum(): ULong
@JvmName(name = "sumOfUShort")
fun Iterable<UShort>.sum(): UInt

Возвращает сумму всех элементов коллекции.

sumBy

Требования к платформе и версии: Common (1.0)

inline fun <T> Iterable<T>.sumBy(selector: (T) -> Int): Int

Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу коллекции.

sumByDouble

Требования к платформе и версии: Common (1.0)

inline fun <T> Iterable<T>.sumByDouble(selector: (T) -> Double): Double

Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу коллекции.

sumOf

Требования к платформе и версии: Common (1.4)

@JvmName(name = "sumOfDouble")
inline fun <T> Iterable<T>.sumOf(selector: (T) -> Double): Double
@JvmName(name = "sumOfInt")
inline fun <T> Iterable<T>.sumOf(selector: (T) -> Int): Int
@JvmName(name = "sumOfLong")
inline fun <T> Iterable<T>.sumOf(selector: (T) -> Long): Long

Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу коллекции.

@JvmName(name = "sumOfUInt")
inline fun <T> Iterable<T>.sumOf(selector: (T) -> UInt): UInt
@JvmName(name = "sumOfULong")
inline fun <T> Iterable<T>.sumOf(selector: (T) -> ULong): ULong

Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу коллекции.

Требования к платформе и версии: JVM (1.4)

@JvmName(name = "sumOfBigDecimal")
inline fun <T> Iterable<T>.sumOf(selector: (T) -> BigDecimal): BigDecimal
@JvmName(name = "sumOfBigInteger")
inline fun <T> Iterable<T>.sumOf(selector: (T) -> BigInteger): BigInteger

Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу коллекции.

take

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.take(n: Int): List<T>

Возвращает список, содержащий первые n элементов.

takeLast

Требования к платформе и версии: Common (1.0)

fun <T> List<T>.takeLast(n: Int): List<T>

Возвращает список, содержащий последние n элементов.

takeLastWhile

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий последние элементы, удовлетворяющие заданному predicate.

takeWhile

Требования к платформе и версии: Common (1.0)

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

Возвращает список, содержащий первые элементы, удовлетворяющие заданному predicate.

toArray

Требования к платформе и версии: JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

protected open fun toArray(): Array<Any?>

Возвращает новый массив типа Array<Any?> с элементами этой коллекции.

protected open fun <T> toArray(array: Array<T>): Array<T>

Заполняет предоставленный array или создаёт новый массив того же типа и заполняет его элементами этой коллекции.

Требования к платформе и версии: JVM (1.1)

open fun toArray(): Array<out Any?>?
open fun <T : Any?> toArray(a: Array<out T?>?): Array<out T?>?
toBooleanArray

Требования к платформе и версии: Common (1.0)

fun Collection<Boolean>.toBooleanArray(): BooleanArray

Возвращает массив Boolean, содержащий все элементы этой коллекции.

toByteArray

Требования к платформе и версии: Common (1.0)

fun Collection<Byte>.toByteArray(): ByteArray

Возвращает массив Byte, содержащий все элементы этой коллекции.

toCharArray

Требования к платформе и версии: Common (1.0)

fun Collection<Char>.toCharArray(): CharArray

Возвращает массив Char, содержащий все элементы этой коллекции.

toCollection

Требования к платформе и версии: Common (1.0)

@IgnorableReturnValue
fun <T, C : MutableCollection<in T>> Iterable<T>.toCollection(destination: C): C

Добавляет все элементы в указанную коллекцию destination.

toCStringArray

Требования к платформе и версии: Native (1.3)

fun List<String>.toCStringArray(autofreeScope: AutofreeScope): CPointer<CPointerVar<ByteVar>>

Преобразует этот список строк Kotlin в массив C-строк, выделяя память для массива и C-строк в указанной области AutofreeScope.

toCValues

Требования к платформе и версии: Native (1.3)

fun <T : CPointed> List<CPointer<T>?>.toCValues(): CValues<CPointerVar<T>>
toDoubleArray

Требования к платформе и версии: Common (1.0)

fun Collection<Double>.toDoubleArray(): DoubleArray

Возвращает массив Double, содержащий все элементы этой коллекции.

toFloatArray

Требования к платформе и версии: Common (1.0)

fun Collection<Float>.toFloatArray(): FloatArray

Возвращает массив Float, содержащий все элементы этой коллекции.

toHashSet

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.toHashSet(): HashSet<T>

Возвращает новый HashSet, содержащий все элементы.

toIntArray

Требования к платформе и версии: Common (1.0)

fun Collection<Int>.toIntArray(): IntArray

Возвращает массив Int, содержащий все элементы этой коллекции.

toJsArray

Требования к платформе и версии: JS (2.2)

@ExperimentalWasmJsInterop
actual inline fun <T> List<T>.toJsArray(): JsArray<T>

Требования к платформе и версии: Wasm-JS (1.8)

@ExperimentalWasmJsInterop
actual fun <T : JsAny?> List<T>.toJsArray(): JsArray<T>

Возвращает новый JsArray, содержащий все элементы этого List.

toList

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.toList(): List<T>

Возвращает List, содержащий все элементы.

toLongArray

Требования к платформе и версии: Common (1.0)

fun Collection<Long>.toLongArray(): LongArray

Возвращает массив Long, содержащий все элементы этой коллекции.

toMap

Требования к платформе и версии: Common (1.0)

fun <K, V> Iterable<Pair<K, V>>.toMap(): Map<K, V>

Возвращает новую карту, содержащую все пары «ключ-значение» из заданной коллекции пар.

@IgnorableReturnValue
fun <K, V, M : MutableMap<in K, in V>> Iterable<Pair<K, V>>.toMap(destination: M): M

Заполняет изменяемую карту назначения парами «ключ-значение» из заданной коллекции пар и возвращает её.

toMutableList

Требования к платформе и версии: Common (1.0)

fun <T> Collection<T>.toMutableList(): MutableList<T>
fun <T> Iterable<T>.toMutableList(): MutableList<T>

Возвращает новый MutableList, заполненный всеми элементами этой коллекции.

toMutableSet

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.toMutableSet(): MutableSet<T>

Возвращает новый MutableSet, содержащий все уникальные элементы заданной коллекции.

toSet

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.toSet(): Set<T>

Возвращает Set, содержащий все элементы.

toShortArray

Требования к платформе и версии: Common (1.0)

fun Collection<Short>.toShortArray(): ShortArray

Возвращает массив Short, содержащий все элементы этой коллекции.

toSortedSet

Требования к платформе и версии: JVM (1.0)

fun <T : Comparable<T>> Iterable<T>.toSortedSet(): SortedSet<T>
fun <T> Iterable<T>.toSortedSet(comparator: Comparator<in T>): SortedSet<T>

Возвращает новый SortedSet, содержащий все элементы.

toString

Требования к платформе и версии: JS (1.1)

open override fun toString(): String

Возвращает строковое представление объекта.

toTypedArray

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect inline fun <T> Collection<T>.toTypedArray(): Array<T>

Возвращает типизированный массив, содержащий все элементы этой коллекции.

toUByteArray

Требования к платформе и версии: Common (1.3)

@ExperimentalUnsignedTypes
fun Collection<UByte>.toUByteArray(): UByteArray

Возвращает массив UByte, содержащий все элементы этой коллекции.

toUIntArray

Требования к платформе и версии: Common (1.3)

@ExperimentalUnsignedTypes
fun Collection<UInt>.toUIntArray(): UIntArray

Возвращает массив UInt, содержащий все элементы этой коллекции.

toULongArray

Требования к платформе и версии: Common (1.3)

@ExperimentalUnsignedTypes
fun Collection<ULong>.toULongArray(): ULongArray

Возвращает массив ULong, содержащий все элементы этой коллекции.

toUShortArray

Требования к платформе и версии: Common (1.3)

@ExperimentalUnsignedTypes
fun Collection<UShort>.toUShortArray(): UShortArray

Возвращает массив UShort, содержащий все элементы этой коллекции.

union

Требования к платформе и версии: Common (1.0)

infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T>

Возвращает множество, содержащее все уникальные элементы обеих коллекций.

unzip

Требования к платформе и версии: Common (1.0)

fun <T, R> Iterable<Pair<T, R>>.unzip(): Pair<List<T>, List<R>>

Возвращает пару списков: первый список формируется из первых значений каждой пары этой коллекции, а второй список — из вторых значений каждой пары этой коллекции.

waitForMultipleFutures

Требования к платформе и версии: Native (1.3)

@ObsoleteWorkersApi
fun <T> Collection<Future<T>>.waitForMultipleFutures(millis: Int): Set<Future<T>>
windowed

Требования к платформе и версии: Common (1.2)

fun <T> Iterable<T>.windowed(size: Int, step: Int = 1, partialWindows: Boolean = false): List<List<T>>

Возвращает список снимков окна заданного размера, перемещающегося по этой коллекции с заданным шагом; каждый снимок представляет собой список.

fun <T, R> Iterable<T>.windowed(size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (List<T>) -> R): List<R>

Возвращает список результатов применения заданной функции преобразования к каждому списку, представляющему окно заданного размера, перемещающееся по этой коллекции с заданным шагом.

withIndex

Требования к платформе и версии: Common (1.0)

fun <T> Iterable<T>.withIndex(): Iterable<IndexedValue<T>>

Возвращает ленивый Iterable, который оборачивает каждый элемент исходной коллекции в IndexedValue, содержащий индекс этого элемента и сам элемент.

zip

Требования к платформе и версии: Common (1.0)

infix fun <T, R> Iterable<T>.zip(other: Array<out R>): List<Pair<T, R>>

Возвращает список пар, составленных из элементов коллекции this и массива other с тем же индексом. Длина возвращаемого списка равна длине более короткой коллекции.

infix fun <T, R> Iterable<T>.zip(other: Iterable<R>): List<Pair<T, R>>

Возвращает список пар, составленных из элементов коллекции this и коллекции other с тем же индексом. Длина возвращаемого списка равна длине более короткой коллекции.

inline fun <T, R, V> Iterable<T>.zip(other: Array<out R>, transform: (a: T, b: R) -> V): List<V>

Возвращает список значений, полученных из элементов коллекции this и массива other с тем же индексом с помощью заданной функции transform, применённой к каждой паре элементов. Длина возвращаемого списка равна длине более короткой коллекции.

inline fun <T, R, V> Iterable<T>.zip(other: Iterable<R>, transform: (a: T, b: R) -> V): List<V>

Возвращает список значений, полученных из элементов коллекции this и коллекции other с тем же индексом с помощью заданной функции transform, применённой к каждой паре элементов. Длина возвращаемого списка равна длине более короткой коллекции.

zipWithNext

Требования к платформе и версии: Common (1.2)

fun <T> Iterable<T>.zipWithNext(): List<Pair<T, T>>

Возвращает список пар из каждых двух соседних элементов этой коллекции.

inline fun <T, R> Iterable<T>.zipWithNext(transform: (a: T, b: T) -> R): List<R>

Возвращает список, содержащий результаты применения заданной функции transform к каждой паре соседних элементов этой коллекции.

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-abstract-mutable-list/index.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API