Spec-Zone.ru › Kotlin 1.4

Двухсторонняя очередь

kotlin-stdlib / kotlin.collections / Двухсторонняя очередь
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
class ArrayDeque<E> : AbstractMutableList<E>

Реализация структуры данных двухсторонняя очередь на основе массива с изменяемым размером.

Название «двухсторонняя очередь» — это сокращение от «двухсторонней очереди» и обычно произносится как «дек».

Коллекция предоставляет методы для удобного доступа к обоим концам. Она также реализует интерфейс MutableList и поддерживает эффективные операции получения/установки по индексу.

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

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

<init>

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

ArrayDeque(initialCapacity: Int)

Создаёт пустую двухстороннюю очередь.

ArrayDeque()

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

ArrayDeque(elements: Collection<E>)

Свойства

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

размер

var size: Int

Функции

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

add

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

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

addAll

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

addFirst

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

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

addLast

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

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

clear

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

contains

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

first

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

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

firstOrNull

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

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

get

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

indexOf

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

isEmpty

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

last

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

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

lastIndexOf

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

lastOrNull

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

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

remove

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

removeAll

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

removeAt

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

removeFirst

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

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

removeFirstOrNull

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

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

removeLast

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

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

removeLastOrNull

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

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

retainAll

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

set

fun set(index: Int, element: E): E

Наследуемые функции

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

containsAll

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

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

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

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

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

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

Заполняет и возвращает целевое изменяемое отображение парами ключ-значение, где ключ предоставляется функцией 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

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

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

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

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, равен предоставленному значению ключ с помощью алгоритма бинарного поиска. Ожидается, что список отсортирован в порядке возрастания в соответствии с естественным порядком сравнения ключей его элементов. В противном случае результат не определён.

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

Разделяет этот набор на несколько списков, каждый из которых не превышает заданный размер и применяет заданную функцию 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

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

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

component2

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

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

component3

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

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

component4

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

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

component5

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

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

contains

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

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

filterIsInstance

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

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

filterIsInstanceTo

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

fun <R, C : MutableCollection<in R>> Iterable<*>.filterIsInstanceTo(
    destination: C
): 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, вызываемой для каждого элемента и его индекса в исходном списке, в заданное назначение.

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

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

Возвращает элемент по заданному индексу или результат вызова функции 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

Возвращает первый индекс 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

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

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

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

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

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

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

mapIndexedNotNullTo

Применяет заданную функцию преобразования к каждому элементу и его индексу в исходной коллекции и добавляет только результаты не-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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

fun <T> MutableList<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

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

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

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

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

runningReduceIndexed

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

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

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

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

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

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

shuffle

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

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

shuffled

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

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

single

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

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

singleOrNull

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

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

slice

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

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

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

fun <T> List<T>.slice(indices: Iterable<Int>): List<T>
Требования к платформе и версии: 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)

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

sumOf

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

fun <T> Iterable<T>.sumOf(selector: (T) -> Double): Double
fun <T> Iterable<T>.sumOf(selector: (T) -> Int): Int
fun <T> Iterable<T>.sumOf(selector: (T) -> Long): Long
fun <T> Iterable<T>.sumOf(selector: (T) -> UInt): UInt
fun <T> Iterable<T>.sumOf(selector: (T) -> ULong): ULong
Требования к платформе и версии: 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

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

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
Требования к платформе и версии: 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.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>>
Требования к платформе и версии: 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>>

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

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

© 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/-array-deque/index.html

Spec-Zone.ru

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