Spec-Zone.ru › Kotlin 1.6

MutableList

kotlin-stdlib / kotlin.collections / MutableList
Требования к платформе и версии: JVM (1.0), JS (1.1), Native (1.3)
interface MutableList<E> : List<E>, MutableCollection<E>

Обобщённое упорядоченное множество элементов, поддерживающее добавление и удаление элементов.

Параметры

E - тип элементов, содержащихся в списке. Мутабельный список инвариантен по типу элементов.

Функции

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

add

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

abstract fun add(element: E): Boolean

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

abstract fun add(index: Int, element: E)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

addAll

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

abstract fun addAll(elements: Collection<E>): Boolean

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

abstract fun addAll(
    index: Int, 
    elements: Collection<E>
): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

clear

Удаляет все элементы из этого набора.

abstract fun clear()
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

listIterator

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

abstract fun listIterator(): MutableListIterator<E>

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

abstract fun listIterator(index: Int): MutableListIterator<E>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

remove

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

abstract fun remove(element: E): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

removeAll

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

abstract fun removeAll(elements: Collection<E>): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

removeAt

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

abstract fun removeAt(index: Int): E
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

retainAll

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

abstract fun retainAll(elements: Collection<E>): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

set

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

abstract operator fun set(index: Int, element: E): E
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

subList

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

abstract fun subList(
    fromIndex: Int, 
    toIndex: Int
): MutableList<E>

Расширяющие свойства

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

indices

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

val Collection<*>.indices: IntRange
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

lastIndex

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

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

Расширяющие функции

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

addAll

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

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

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

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

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

fun <T> MutableCollection<in T>.addAll(
    elements: Array<out T>
): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

all

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

fun <T> Iterable<T>.all(predicate: (T) -> Boolean): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

any

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

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

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

fun <T> Iterable<T>.any(predicate: (T) -> Boolean): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

asIterable

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

fun <T> Iterable<T>.asIterable(): Iterable<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

asReversed

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

fun <T> MutableList<T>.asReversed(): MutableList<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

asSequence

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

fun <T> Iterable<T>.asSequence(): Sequence<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

associate

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

fun <T, K, V> Iterable<T>.associate(
    transform: (T) -> Pair<K, V>
): Map<K, V>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

associateBy

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

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

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

fun <T, K, V> Iterable<T>.associateBy(
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): Map<K, V>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

associateByTo

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

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

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

fun <T, K, V, M : MutableMap<in K, in V>> Iterable<T>.associateByTo(
    destination: M, 
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): M
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

associateTo

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

fun <T, K, V, M : MutableMap<in K, in V>> Iterable<T>.associateTo(
    destination: M, 
    transform: (T) -> Pair<K, V>
): M
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

associateWith

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

fun <K, V> Iterable<K>.associateWith(
    valueSelector: (K) -> V
): Map<K, V>
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

associateWithTo

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

fun <K, V, M : MutableMap<in K, in V>> Iterable<K>.associateWithTo(
    destination: M, 
    valueSelector: (K) -> V
): M
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

binarySearch

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

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

Ищет в этом списке или его диапазоне элемент, для которого заданная функция сравнения comparison возвращает ноль с использованием алгоритма бинарного поиска.

fun <T> List<T>.binarySearch(
    fromIndex: Int = 0, 
    toIndex: Int = size, 
    comparison: (T) -> Int
): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

binarySearchBy

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

fun <T, K : Comparable<K>> List<T>.binarySearchBy(
    key: K?, 
    fromIndex: Int = 0, 
    toIndex: Int = size, 
    selector: (T) -> K?
): Int
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)

chunked

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

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

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

fun <T, R> Iterable<T>.chunked(
    size: Int, 
    transform: (List<T>) -> R
): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

component1

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

operator fun <T> List<T>.component1(): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

component2

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

operator fun <T> List<T>.component2(): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

component3

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

operator fun <T> List<T>.component3(): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

component4

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

operator fun <T> List<T>.component4(): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

component5

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

operator fun <T> List<T>.component5(): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

contains

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

operator fun <T> Iterable<T>.contains(element: T): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

containsAll

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

fun <T> Collection<T>.containsAll(
    elements: Collection<T>
): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

count

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

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

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

distinct

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

fun <T> Iterable<T>.distinct(): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

distinctBy

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

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

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

drop

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

fun <T> Iterable<T>.drop(n: Int): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

dropLast

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

fun <T> List<T>.dropLast(n: Int): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

dropLastWhile

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

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

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

dropWhile

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

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

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

elementAtOrElse

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

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

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

fun <T> List<T>.elementAtOrElse(
    index: Int, 
    defaultValue: (Int) -> T
): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

filter

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

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

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

filterIndexed

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

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

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

filterIndexedTo

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

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

filterIsInstance

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

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

fun <R> Iterable<*>.filterIsInstance(): List<R>
Требования к платформе и версии: JVM (1.0)

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

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

filterIsInstanceTo

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

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

fun <R, C : MutableCollection<in R>> Iterable<*>.filterIsInstanceTo(
    destination: C
): C
Требования к платформе и версии: JVM (1.0)

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

fun <C : MutableCollection<in R>, R> Iterable<*>.filterIsInstanceTo(
    destination: C, 
    klass: Class<R>
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

filterNot

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

fun <T> Iterable<T>.filterNot(
    predicate: (T) -> Boolean
): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

filterNotNull

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

fun <T : Any> Iterable<T?>.filterNotNull(): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

filterNotNullTo

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

fun <C : MutableCollection<in T>, T : Any> Iterable<T?>.filterNotNullTo(
    destination: C
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

filterNotTo

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

fun <T, C : MutableCollection<in T>> Iterable<T>.filterNotTo(
    destination: C, 
    predicate: (T) -> Boolean
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

filterTo

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

fun <T, C : MutableCollection<in T>> Iterable<T>.filterTo(
    destination: C, 
    predicate: (T) -> Boolean
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

find

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

fun <T> Iterable<T>.find(predicate: (T) -> Boolean): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

findLast

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

fun <T> Iterable<T>.findLast(predicate: (T) -> Boolean): T?
fun <T> List<T>.findLast(predicate: (T) -> Boolean): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

first

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

fun <T> Iterable<T>.first(predicate: (T) -> Boolean): T
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)

firstNotNullOf

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

fun <T, R : Any> Iterable<T>.firstNotNullOf(
    transform: (T) -> R?
): R
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)

firstNotNullOfOrNull

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

fun <T, R : Any> Iterable<T>.firstNotNullOfOrNull(
    transform: (T) -> R?
): R?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

firstOrNull

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

fun <T> Iterable<T>.firstOrNull(
    predicate: (T) -> Boolean
): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

flatMap

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

fun <T, R> Iterable<T>.flatMap(
    transform: (T) -> Iterable<R>
): List<R>
fun <T, R> Iterable<T>.flatMap(
    transform: (T) -> Sequence<R>
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

flatMapIndexed

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

fun <T, R> Iterable<T>.flatMapIndexed(
    transform: (index: Int, T) -> Iterable<R>
): List<R>
fun <T, R> Iterable<T>.flatMapIndexed(
    transform: (index: Int, T) -> Sequence<R>
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

flatMapIndexedTo

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

fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapIndexedTo(
    destination: C, 
    transform: (index: Int, T) -> Iterable<R>
): C
fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapIndexedTo(
    destination: C, 
    transform: (index: Int, T) -> Sequence<R>
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

flatMapTo

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

fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapTo(
    destination: C, 
    transform: (T) -> Iterable<R>
): C
fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapTo(
    destination: C, 
    transform: (T) -> Sequence<R>
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

flatten

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

fun <T> Iterable<Iterable<T>>.flatten(): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

fold

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

fun <T, R> Iterable<T>.fold(
    initial: R, 
    operation: (acc: R, T) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

foldIndexed

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

fun <T, R> Iterable<T>.foldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, T) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

foldRight

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

fun <T, R> List<T>.foldRight(
    initial: R, 
    operation: (T, acc: R) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

foldRightIndexed

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

fun <T, R> List<T>.foldRightIndexed(
    initial: R, 
    operation: (index: Int, T, acc: R) -> R
): R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

forEach

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

fun <T> Iterable<T>.forEach(action: (T) -> Unit)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

forEachIndexed

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

fun <T> Iterable<T>.forEachIndexed(
    action: (index: Int, T) -> Unit)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

getOrElse

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

fun <T> List<T>.getOrElse(
    index: Int, 
    defaultValue: (Int) -> T
): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

getOrNull

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

fun <T> List<T>.getOrNull(index: Int): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

groupBy

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

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

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

fun <T, K, V> Iterable<T>.groupBy(
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): Map<K, List<V>>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

groupByTo

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

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

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

fun <T, K, V, M : MutableMap<in K, MutableList<V>>> Iterable<T>.groupByTo(
    destination: M, 
    keySelector: (T) -> K, 
    valueTransform: (T) -> V
): M
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)

groupingBy

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

fun <T, K> Iterable<T>.groupingBy(
    keySelector: (T) -> K
): Grouping<T, K>
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

ifEmpty

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

fun <C, R> C.ifEmpty(
    defaultValue: () -> R
): R where C : Array<*>, C : R
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

indexOf

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

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

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

fun <T> List<T>.indexOf(element: T): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

indexOfFirst

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

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

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

fun <T> List<T>.indexOfFirst(predicate: (T) -> Boolean): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

indexOfLast

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

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

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

fun <T> List<T>.indexOfLast(predicate: (T) -> Boolean): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

intersect

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

infix fun <T> Iterable<T>.intersect(
    other: Iterable<T>
): Set<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

isNotEmpty

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

fun <T> Collection<T>.isNotEmpty(): Boolean
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

isNullOrEmpty

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

fun <T> Collection<T>?.isNullOrEmpty(): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

joinTo

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

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
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

joinToString

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

fun <T> Iterable<T>.joinToString(
    separator: CharSequence = ", ", 
    prefix: CharSequence = "", 
    postfix: CharSequence = "", 
    limit: Int = -1, 
    truncated: CharSequence = "...", 
    transform: ((T) -> CharSequence)? = null
): String
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

last

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

fun <T> Iterable<T>.last(predicate: (T) -> Boolean): T
fun <T> List<T>.last(predicate: (T) -> Boolean): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

lastIndexOf

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

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

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

fun <T> List<T>.lastIndexOf(element: T): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

lastOrNull

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

fun <T> Iterable<T>.lastOrNull(predicate: (T) -> Boolean): T?
fun <T> List<T>.lastOrNull(predicate: (T) -> Boolean): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

map

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

fun <T, R> Iterable<T>.map(transform: (T) -> R): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

mapIndexed

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

fun <T, R> Iterable<T>.mapIndexed(
    transform: (index: Int, T) -> R
): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

mapIndexedNotNull

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

fun <T, R : Any> Iterable<T>.mapIndexedNotNull(
    transform: (index: Int, T) -> R?
): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

mapIndexedNotNullTo

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

fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapIndexedNotNullTo(
    destination: C, 
    transform: (index: Int, T) -> R?
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

mapIndexedTo

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

fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo(
    destination: C, 
    transform: (index: Int, T) -> R
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

mapNotNull

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

fun <T, R : Any> Iterable<T>.mapNotNull(
    transform: (T) -> R?
): List<R>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

mapNotNullTo

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

fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo(
    destination: C, 
    transform: (T) -> R?
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

mapTo

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

fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapTo(
    destination: C, 
    transform: (T) -> R
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

maxBy

fun <T, R : Comparable<R>> Iterable<T>.maxBy(
    selector: (T) -> R
): T?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

maxByOrNull

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

fun <T, R : Comparable<R>> Iterable<T>.maxByOrNull(
    selector: (T) -> R
): T?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

maxOf

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

fun <T> Iterable<T>.maxOf(selector: (T) -> Double): Double
fun <T> Iterable<T>.maxOf(selector: (T) -> Float): Float
fun <T, R : Comparable<R>> Iterable<T>.maxOf(
    selector: (T) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

maxOfOrNull

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

fun <T> Iterable<T>.maxOfOrNull(
    selector: (T) -> Double
): Double?
fun <T> Iterable<T>.maxOfOrNull(
    selector: (T) -> Float
): Float?
fun <T, R : Comparable<R>> Iterable<T>.maxOfOrNull(
    selector: (T) -> R
): R?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

maxOfWith

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

fun <T, R> Iterable<T>.maxOfWith(
    comparator: Comparator<in R>, 
    selector: (T) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

maxOfWithOrNull

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

fun <T, R> Iterable<T>.maxOfWithOrNull(
    comparator: Comparator<in R>, 
    selector: (T) -> R
): R?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

maxWith

fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

maxWithOrNull

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

fun <T> Iterable<T>.maxWithOrNull(
    comparator: Comparator<in T>
): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

minBy

fun <T, R : Comparable<R>> Iterable<T>.minBy(
    selector: (T) -> R
): T?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

minByOrNull

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

fun <T, R : Comparable<R>> Iterable<T>.minByOrNull(
    selector: (T) -> R
): T?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

minOf

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

fun <T> Iterable<T>.minOf(selector: (T) -> Double): Double
fun <T> Iterable<T>.minOf(selector: (T) -> Float): Float
fun <T, R : Comparable<R>> Iterable<T>.minOf(
    selector: (T) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

minOfOrNull

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

fun <T> Iterable<T>.minOfOrNull(
    selector: (T) -> Double
): Double?
fun <T> Iterable<T>.minOfOrNull(
    selector: (T) -> Float
): Float?
fun <T, R : Comparable<R>> Iterable<T>.minOfOrNull(
    selector: (T) -> R
): R?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

minOfWith

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

fun <T, R> Iterable<T>.minOfWith(
    comparator: Comparator<in R>, 
    selector: (T) -> R
): R
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

minOfWithOrNull

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

fun <T, R> Iterable<T>.minOfWithOrNull(
    comparator: Comparator<in R>, 
    selector: (T) -> R
): R?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

minus

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

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

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

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>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

minusAssign

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

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

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

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

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

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

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

operator fun <T> MutableCollection<in T>.minusAssign(
    elements: Sequence<T>)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

minusElement

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

fun <T> Iterable<T>.minusElement(element: T): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

minWith

fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

minWithOrNull

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

fun <T> Iterable<T>.minWithOrNull(
    comparator: Comparator<in T>
): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

none

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

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

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

fun <T> Iterable<T>.none(predicate: (T) -> Boolean): Boolean
Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)

onEach

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

fun <T, C : Iterable<T>> C.onEach(action: (T) -> Unit): C
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

onEachIndexed

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

fun <T, C : Iterable<T>> C.onEachIndexed(
    action: (index: Int, T) -> Unit
): C
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

partition

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

fun <T> Iterable<T>.partition(
    predicate: (T) -> Boolean
): Pair<List<T>, List<T>>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

plus

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

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

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

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

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

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

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

operator fun <T> Iterable<T>.plus(
    elements: Sequence<T>
): List<T>
operator fun <T> Collection<T>.plus(
    elements: Sequence<T>
): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

plusAssign

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

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

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

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

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

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

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

operator fun <T> MutableCollection<in T>.plusAssign(
    elements: Sequence<T>)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

plusElement

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

fun <T> Iterable<T>.plusElement(element: T): List<T>
fun <T> Collection<T>.plusElement(element: T): List<T>
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

random

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

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

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

fun <T> Collection<T>.random(random: Random): T
END_OF_DOCUMENT_MARKER
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

randomOrNull

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

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

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

fun <T> Collection<T>.randomOrNull(random: Random): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

reduce

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

fun <S, T : S> Iterable<T>.reduce(
    operation: (acc: S, T) -> S
): S
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

reduceIndexed

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

fun <S, T : S> Iterable<T>.reduceIndexed(
    operation: (index: Int, acc: S, T) -> S
): S
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

reduceIndexedOrNull

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

fun <S, T : S> Iterable<T>.reduceIndexedOrNull(
    operation: (index: Int, acc: S, T) -> S
): S?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

reduceOrNull

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

fun <S, T : S> Iterable<T>.reduceOrNull(
    operation: (acc: S, T) -> S
): S?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

reduceRight

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

fun <S, T : S> List<T>.reduceRight(
    operation: (T, acc: S) -> S
): S
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

reduceRightIndexed

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

fun <S, T : S> List<T>.reduceRightIndexed(
    operation: (index: Int, T, acc: S) -> S
): S
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

reduceRightIndexedOrNull

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

fun <S, T : S> List<T>.reduceRightIndexedOrNull(
    operation: (index: Int, T, acc: S) -> S
): S?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

reduceRightOrNull

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

fun <S, T : S> List<T>.reduceRightOrNull(
    operation: (T, acc: S) -> S
): S?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

remove

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

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

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

fun <T> MutableCollection<out T>.remove(element: T): Boolean
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

удалениеВсех

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

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

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

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

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

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

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

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

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

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

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

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

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

удалитьПервый

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

fun <T> MutableList<T>.removeFirst(): T
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

удалитьПервыйИлиNull

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

fun <T> MutableList<T>.removeFirstOrNull(): T?
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

удалитьПоследний

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

fun <T> MutableList<T>.removeLast(): T
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

удалитьПоследнийИлиNull

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

fun <T> MutableList<T>.removeLastOrNull(): T?
Требования к платформе и версии: Native (1.3)

заменитьВсе

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

fun <T> MutableList<T>.replaceAll(transformation: (T) -> T)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

сохранитьВсе

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

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

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

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

Оставляет только элементы этого MutableCollection, которые содержатся в заданном наборе

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

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

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

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

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

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

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

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

обратныйПорядок

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

fun <T> Iterable<T>.reversed(): List<T>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

runningFold

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

fun <T, R> Iterable<T>.runningFold(
    initial: R, 
    operation: (acc: R, T) -> R
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

runningFoldIndexed

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

fun <T, R> Iterable<T>.runningFoldIndexed(
    initial: R, 
    operation: (index: Int, acc: R, T) -> R
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

runningReduce

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

fun <S, T : S> Iterable<T>.runningReduce(
    operation: (acc: S, T) -> S
): List<S>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

runningReduceIndexed

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

fun <S, T : S> Iterable<T>.runningReduceIndexed(
    operation: (index: Int, acc: S, T) -> S
): List<S>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

scan

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

fun <T, R> Iterable<T>.scan(
    initial: R, 
    operation: (acc: R, T) -> R
): List<R>
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)

scanIndexed

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

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

shuffle

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

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

fun <T> MutableList<T>.shuffle(random: Random)
Требования к платформе и версии: JVM (1.2)

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

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

shuffled

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

Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)
fun <T> Iterable<T>.shuffled(random: Random): List<T>
Требования к платформе и версии: JVM (1.2)
fun <T> Iterable<T>.shuffled(random: Random): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

single

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

fun <T> Iterable<T>.single(predicate: (T) -> Boolean): T
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

singleOrNull

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

fun <T> Iterable<T>.singleOrNull(
    predicate: (T) -> Boolean
): T?
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

slice

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

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

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

fun <T> List<T>.slice(indices: Iterable<Int>): List<T>
Требования к платформе и версии: JVM (1.0)

sort

fun <T> MutableList<T>.sort(comparator: Comparator<in T>)
fun <T> MutableList<T>.sort(comparison: (T, T) -> Int)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sortBy

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

fun <T, R : Comparable<R>> MutableList<T>.sortBy(
    selector: (T) -> R?)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sortByDescending

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

fun <T, R : Comparable<R>> MutableList<T>.sortByDescending(
    selector: (T) -> R?)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sortDescending

Сортирует элементы в списке на месте в обратном порядке в соответствии с их естественным порядком сортировки.

fun <T : Comparable<T>> MutableList<T>.sortDescending()
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sortedBy

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

fun <T, R : Comparable<R>> Iterable<T>.sortedBy(
    selector: (T) -> R?
): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sortedByDescending

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

fun <T, R : Comparable<R>> Iterable<T>.sortedByDescending(
    selector: (T) -> R?
): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sortedWith

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

fun <T> Iterable<T>.sortedWith(
    comparator: Comparator<in T>
): List<T>
Требования к платформе и версии: JVM (1.0)

sortWith

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

fun <T> MutableList<T>.sortWith(comparator: Comparator<in T>)
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

subtract

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

infix fun <T> Iterable<T>.subtract(
    other: Iterable<T>
): Set<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sumBy

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

fun <T> Iterable<T>.sumBy(selector: (T) -> Int): Int
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

sumByDouble

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

fun <T> Iterable<T>.sumByDouble(
    selector: (T) -> Double
): Double

sumOf

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

Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun <T> Iterable<T>.sumOf(selector: (T) -> Double): Double
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun <T> Iterable<T>.sumOf(selector: (T) -> Int): Int
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun <T> Iterable<T>.sumOf(selector: (T) -> Long): Long
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
fun <T> Iterable<T>.sumOf(selector: (T) -> UInt): UInt
Требования к платформе и версии: JVM (1.5), JS (1.5), Native (1.5)
fun <T> Iterable<T>.sumOf(selector: (T) -> ULong): ULong
Требования к платформе и версии: JVM (1.4)
fun <T> Iterable<T>.sumOf(
    selector: (T) -> BigDecimal
): BigDecimal
Требования к платформе и версии: JVM (1.4)
fun <T> Iterable<T>.sumOf(
    selector: (T) -> BigInteger
): BigInteger
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

take

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

fun <T> Iterable<T>.take(n: Int): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

takeLast

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

fun <T> List<T>.takeLast(n: Int): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

takeLastWhile

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

fun <T> List<T>.takeLastWhile(
    predicate: (T) -> Boolean
): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

takeWhile

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

fun <T> Iterable<T>.takeWhile(
    predicate: (T) -> Boolean
): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toBooleanArray

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

fun Collection<Boolean>.toBooleanArray(): BooleanArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toByteArray

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

fun Collection<Byte>.toByteArray(): ByteArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toCharArray

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

fun Collection<Char>.toCharArray(): CharArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toCollection

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

fun <T, C : MutableCollection<in T>> Iterable<T>.toCollection(
    destination: C
): C
Требования к платформе и версии: Native (1.3)

toCStringArray

Преобразует этот список строк Kotlin в C-массив C-строк, выделяя память для массива и C-строк с заданным AutofreeScope.

fun List<String>.toCStringArray(
    autofreeScope: AutofreeScope
): CPointer<CPointerVar<ByteVar>>
Требования к платформе и версии: Native (1.3)

toCValues

fun <T : CPointed> List<CPointer<T>?>.toCValues(): CValues<CPointerVar<T>>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toDoubleArray

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

fun Collection<Double>.toDoubleArray(): DoubleArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toFloatArray

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

fun Collection<Float>.toFloatArray(): FloatArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toHashSet

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

fun <T> Iterable<T>.toHashSet(): HashSet<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toIntArray

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

fun Collection<Int>.toIntArray(): IntArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toList

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

fun <T> Iterable<T>.toList(): List<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toLongArray

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

fun Collection<Long>.toLongArray(): LongArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toMap

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

fun <K, V> Iterable<Pair<K, V>>.toMap(): Map<K, V>

Заполняет и возвращает изменяемую карту destination парами ключ-значение из данной коллекции пар.

fun <K, V, M : MutableMap<in K, in V>> Iterable<Pair<K, V>>.toMap(
    destination: M
): M
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toMutableSet

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

fun <T> Iterable<T>.toMutableSet(): MutableSet<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toSet

Возвращает Set всех элементов.

fun <T> Iterable<T>.toSet(): Set<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

toShortArray

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

fun Collection<Short>.toShortArray(): ShortArray
Требования к платформе и версии: JVM (1.0)

toSortedSet

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

fun <T> Iterable<T>.toSortedSet(
    comparator: Comparator<in T>
): SortedSet<T>
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

toUByteArray

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

fun Collection<UByte>.toUByteArray(): UByteArray
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

toUIntArray

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

fun Collection<UInt>.toUIntArray(): UIntArray
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

toULongArray

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

fun Collection<ULong>.toULongArray(): ULongArray
Требования к платформе и версии: JVM (1.3), JS (1.3), Native (1.3)

toUShortArray

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

fun Collection<UShort>.toUShortArray(): UShortArray
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

union

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

infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

unzip

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

fun <T, R> Iterable<Pair<T, R>>.unzip(): Pair<List<T>, List<R>>
Требования к платформе и версии: Native (1.3)

waitForMultipleFutures

fun <T> Collection<Future<T>>.waitForMultipleFutures(
    millis: Int
): Set<Future<T>>
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)

windowed

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

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>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

withIndex

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

fun <T> Iterable<T>.withIndex(): Iterable<IndexedValue<T>>
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)

zip

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

infix fun <T, R> Iterable<T>.zip(
    other: Array<out R>
): List<Pair<T, R>>

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

fun <T, R, V> Iterable<T>.zip(
    other: Array<out R>, 
    transform: (a: T, b: R) -> V
): List<V>

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

infix fun <T, R> Iterable<T>.zip(
    other: Iterable<R>
): List<Pair<T, R>>

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

fun <T, R, V> Iterable<T>.zip(
    other: Iterable<R>, 
    transform: (a: T, b: R) -> V
): List<V>
Требования к платформе и версии: JVM (1.2), JS (1.2), Native (1.2)

zipWithNext

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

fun <T> Iterable<T>.zipWithNext(): List<Pair<T, T>>

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

fun <T, R> Iterable<T>.zipWithNext(
    transform: (a: T, b: T) -> R
): List<R>

Наследники

Абстрактный список с изменяемыми элементами

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

Требования к платформе и версии:
abstract class AbstractMutableList<E> : MutableList<E>
Требования к платформе и версии: JVM (1.1)
abstract class AbstractMutableList<E> : 
    MutableList<E>, 
    AbstractList<E>
Требования к платформе и версии: JS (1.1), Native (1.3)
abstract class AbstractMutableList<E> : 
    AbstractMutableCollection<E>, 
    MutableList<E>

Список массивов

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

Требования к платформе и версии:
class ArrayList<E> : MutableList<E>, RandomAccess
Требования к платформе и версии: JVM (1.1)
typealias ArrayList<E> = ArrayList<E>
Требования к платформе и версии: JS (1.1)
open class ArrayList<E> : 
    AbstractMutableList<E>, 
    MutableList<E>, 
    RandomAccess
Требования к платформе и версии: Native (1.3)
class ArrayList<E> : 
    MutableList<E>, 
    RandomAccess, 
    AbstractMutableList<E>

© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-mutable-list/index.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API