Spec-Zone.ru › Kotlin 1.4

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.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, вызываемой для каждого элемента и его индекса в исходной коллекции, в указанный destination.

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, вызываемой для каждого элемента исходной коллекции, в указанный destination.

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

Накапливает значение, начиная с initial значения и применяя 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

Накапливает значение, начиная с initial значения и применяя 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

Накапливает значение, начиная с initial значения и применяя 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

Накапливает значение, начиная с initial значения и применяя 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

Выполняет заданное action для каждого элемента.

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

forEachIndexed

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

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

getOrElse

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

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

getOrNull

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

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

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

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

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

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

indexOfFirst

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

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

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

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

indexOfLast

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

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

Возвращает индекс последнего элемента, удовлетворяющего заданному predicate, или -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 если этот коллекция с nullable элементами является 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

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

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

mapIndexed

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

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

mapIndexedNotNull

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

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

mapIndexedNotNullTo

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

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

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

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

Возвращает первый элемент с наименьшим значением согласно предоставленному comparator или 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
Требования к платформе и версии: 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

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

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

reduceIndexed

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

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

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

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

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

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

reduceRight

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

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

reduceRightIndexed

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

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

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

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

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

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

scanReduce

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

scanReduceIndexed

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

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

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

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

sortByDescending

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

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

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

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

sortedByDescending

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

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

sortedWith

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

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

sortWith

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

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

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

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

sumByDouble

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

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

sumOf

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

Требования к платформе и версии: 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.4), JS (1.4), Native (1.4)
fun <T> Iterable<T>.sumOf(selector: (T) -> UInt): UInt
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
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

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

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

Добавляет все элементы в заданный назначенный набор.

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

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

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>

Заполняет и возвращает назначенный изменяемый массив парами ключ-значение из заданного набора пар.

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

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

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

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

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

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

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

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

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

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

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>>

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

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

Наследники

AbstractMutableList

Предоставляет скелетное реализацию интерфейса 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>

ArrayList

Предоставляет реализацию 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–2020 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