Spec-Zone.ru › Kotlin 1.9

ArrayDeque

kotlin-stdlib / kotlin.collections / ArrayDeque
Требования к платформе и версии: 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, если этот deque пуст.

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

firstOrNull

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

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, если этот deque пуст.

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 , если этот deque пуст.

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

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

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

removeFirstOrNull

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

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

removeLast

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

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

removeLastOrNull

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

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

toArray

fun <T> toArray(array: Array<T>): Array<T>
fun toArray(): Array<Any?>

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

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

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

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

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

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

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

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

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

Заполняет и возвращает и значение предоставляется функцией

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

Заполняет и возвращает , применённой к каждому элементу заданной коллекции.

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

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

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

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

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

filterNotNullTo

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

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

filterNotTo

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

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

filterTo

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

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

find

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

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

findLast

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

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

first

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

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

firstNotNullOf

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

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

firstNotNullOfOrNull

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

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

firstOrNull

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

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

flatMap

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

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

flatMapIndexed

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

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

flatMapIndexedTo

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

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

flatMapTo

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

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

flatten

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

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

fold

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

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

foldIndexed

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

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)

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

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

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

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

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

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

lastOrNull

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

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

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

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

mapNotNullTo

Применяет заданную функцию transform к каждому элементу в исходном наборе и добавляет только результаты, не равные null, в заданное значение 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.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)

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.7), JS (1.7), Native (1.7)

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)

removeAll

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

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

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

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

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

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

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

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)

removeFirst

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

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

removeFirstOrNull

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

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

removeLast

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

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

removeLastOrNull

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

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

retainAll

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

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

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

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

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

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

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

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

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

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

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

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

reversed

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

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

runningFold

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

fun <T, R> Iterable<T>.runningFold(
    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)

shuffle

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

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

shuffled

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

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

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

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>

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

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

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)

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)

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>

© 2010–2023 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