Список с возможностью изменения размера (ArrayList)
class ArrayList<E> : MutableList<E>, RandomAccess
typealias ArrayList<E> = ArrayList<E>
open class ArrayList<E> : AbstractMutableList<E>, MutableList<E>, RandomAccess
Предоставляет реализацию MutableList, которая использует изменяемый массив в качестве базового хранилища.
Данная реализация не предоставляет способ управления емкостью, так как базовый JS-массив сам изменяет размер. Предопределения размера массива в JavaScript не дают преимущества в скорости, поэтому данная реализация не включает понятия емкости и «приращения роста».
Конструкторы
<init>
Создаёт пустой Список с возможностью изменения размера (ArrayList).
<init>()
<init>(initialCapacity: Int)
Создаёт Список с возможностью изменения размера (ArrayList), заполненный элементами из коллекции.
<init>(elements: Collection<E>)
Свойства
размер
val size: Int
open val size: Int
Наследуемые свойства
modCount
var modCount: Int
Функции
добавить
Добавляет указанный элемент в конец этого списка.
fun add(element: E): Boolean
open fun add(element: E): Boolean
Вставляет элемент в список по указанному индексу.
fun add(index: Int, element: E)
open fun add(index: Int, element: E)
добавитьВсе
Добавляет все элементы указанной коллекции в конец этого списка.
fun addAll(elements: Collection<E>): Boolean
open fun addAll(elements: Collection<E>): Boolean
очистить
Удаляет все элементы из этой коллекции.
fun clear()
open fun clear()
содержит
fun contains(element: E): Boolean
содержитВсе
fun containsAll(elements: Collection<E>): Boolean
зарезервироватьЕмкость
В этой реализации ArrayList ничего не делает.
fun ensureCapacity(minCapacity: Int)
получить
Возвращает элемент по указанному индексу в списке.
operator fun get(index: Int): E
open fun get(index: Int): E
индекс
Возвращает индекс первого вхождения указанного элемента в список или -1, если указанный элемент не содержится в списке.
fun indexOf(element: E): Int
open fun indexOf(element: E): Int
пустой
fun isEmpty(): Boolean
итератор
fun iterator(): MutableIterator<E>
последнийИндекс
Возвращает индекс последнего вхождения указанного элемента в список или -1, если указанный элемент не содержится в списке.
fun lastIndexOf(element: E): Int
open fun lastIndexOf(element: E): Int
итераторСписка
fun listIterator(): MutableListIterator<E>
fun listIterator(index: Int): MutableListIterator<E>
удалить
Удаляет единственный экземпляр указанного элемента из этой коллекции, если он присутствует.
fun remove(element: E): Boolean
open fun remove(element: E): Boolean
удалитьВсе
fun removeAll(elements: Collection<E>): Boolean
удалитьПоИндексу
Удаляет элемент по указанному индексу из списка.
fun removeAt(index: Int): E
open fun removeAt(index: Int): E
удалитьДиапазон
сохранитьВсе
fun retainAll(elements: Collection<E>): Boolean
установить
Заменяет элемент в указанной позиции в этом списке указанным элементом.
operator fun set(index: Int, element: E): E
open fun set(index: Int, element: E): E
подСписок
fun subList(fromIndex: Int, toIndex: Int): MutableList<E>
вМассив
open fun <T> toArray(array: Array<T>): Array<T>
open fun toArray(): Array<Any?>
вСтроку
open fun toString(): String
обрезатьДоРазмеры
В этой реализации ArrayList ничего не делает.
fun trimToSize()
Наследованные функции
containsAll
open fun containsAll(elements: Collection<E>): Boolean
equals
Сравнивает этот список с другим экземпляром списка с упорядоченным структурным равенством.
open fun equals(other: Any?): Boolean
hashCode
Возвращает значение хэш-кода для этого списка.
open fun hashCode(): Int
isEmpty
open fun isEmpty(): Boolean
Расширяемые свойства
indices
Возвращает диапазон IntRange допустимых индексов для этого набора.
val Collection<*>.indices: IntRange
lastIndex
Возвращает индекс последнего элемента в списке или -1, если список пуст.
val <T> List<T>.lastIndex: Int
Расширяемые функции
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
all
Возвращает true если все элементы соответствуют заданному предикату.
fun <T> Iterable<T>.all(predicate: (T) -> Boolean): Boolean
any
Возвращает true если коллекция имеет хотя бы один элемент.
fun <T> Iterable<T>.any(): Boolean
Возвращает true если хотя бы один элемент соответствует заданному предикату.
fun <T> Iterable<T>.any(predicate: (T) -> Boolean): Boolean
asIterable
Возвращает эту коллекцию как Iterable.
fun <T> Iterable<T>.asIterable(): Iterable<T>
asSequence
Создает экземпляр Sequence, который оборачивает исходную коллекцию, возвращая ее элементы при итерации.
fun <T> Iterable<T>.asSequence(): Sequence<T>
associate
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>
associateByTo
Заполняет и возвращает целевой изменяемый map парами ключ-значение, где ключ предоставляется функцией keySelector, примененной к каждому элементу заданной коллекции, а значением является сам элемент.
fun <T, K, M : MutableMap<in K, in T>> Iterable<T>.associateByTo( destination: M, keySelector: (T) -> K ): M
Заполняет и возвращает целевой изменяемый map парами ключ-значение, где ключ предоставляется функцией keySelector, а значение предоставляется функцией valueTransform, примененной к элементам заданной коллекции.
fun <T, K, V, M : MutableMap<in K, in V>> Iterable<T>.associateByTo( destination: M, keySelector: (T) -> K, valueTransform: (T) -> V ): M
associateTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, полученными из функции transform, применённой к каждому элементу заданного набора.
fun <T, K, V, M : MutableMap<in K, in V>> Iterable<T>.associateTo( destination: M, transform: (T) -> Pair<K, V> ): M
associateWith
Возвращает Map, где ключи — элементы из заданного набора, а значения — результаты применения функции valueSelector к каждому элементу.
fun <K, V> Iterable<K>.associateWith( valueSelector: (K) -> V ): Map<K, V>
associateWithTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение для каждого элемента заданного набора, где ключом является сам элемент, а значением — результат применения функции valueSelector к этому ключу.
fun <K, V, M : MutableMap<in K, in V>> Iterable<K>.associateWithTo( destination: M, valueSelector: (K) -> V ): M
binarySearch
Ищет заданный элемент в этом списке или его диапазоне с помощью алгоритма бинарного поиска. Ожидается, что список отсортирован в порядке возрастания по заданному компаратору, в противном случае результат не определён.
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
binarySearchBy
Ищет в этом списке или его диапазоне элемент, у которого значение ключа, возвращаемое заданной функцией selector, равно предоставленному значению ключа key с помощью алгоритма бинарного поиска. Ожидается, что список отсортирован в порядке возрастания по естественному порядку сортировки ключей его элементов; в противном случае результат не определен.
fun <T, K : Comparable<K>> List<T>.binarySearchBy( key: K?, fromIndex: Int = 0, toIndex: Int = size, selector: (T) -> K? ): Int
chunked
Разделяет этот набор на список списков, каждый из которых не превышает заданного размера size.
fun <T> Iterable<T>.chunked(size: Int): List<List<T>>
component1
Возвращает первый элемент из списка.
operator fun <T> List<T>.component1(): T
component2
Возвращает второй элемент из списка.
operator fun <T> List<T>.component2(): T
component3
Возвращает третий элемент из списка.
operator fun <T> List<T>.component3(): T
component4
Возвращает четвёртый элемент из списка.
operator fun <T> List<T>.component4(): T
component5
Возвращает пятый элемент из списка.
operator fun <T> List<T>.component5(): T
containsAll
Проверяет, содержатся ли все элементы указанного набора в этом наборе.
fun <T> Collection<T>.containsAll( elements: Collection<T> ): Boolean
count
Возвращает количество элементов, соответствующих заданному
fun <T> Iterable<T>.count(predicate: (T) -> Boolean): Int
distinct
Возвращает список, содержащий только уникальные элементы из заданного набора.
fun <T> Iterable<T>.distinct(): List<T>
distinctBy
Возвращает список, содержащий только элементы из заданного набора, имеющие уникальные ключи, возвращаемые заданной функцией
fun <T, K> Iterable<T>.distinctBy(
selector: (T) -> K
): List<T>
drop
Возвращает список, содержащий все элементы, кроме первых n элементов.
fun <T> Iterable<T>.drop(n: Int): List<T>
dropLast
Возвращает список, содержащий все элементы, кроме последних n элементов.
fun <T> List<T>.dropLast(n: Int): List<T>
dropLastWhile
Возвращает список, содержащий все элементы, кроме последних элементов, удовлетворяющих заданному
fun <T> List<T>.dropLastWhile(
predicate: (T) -> Boolean
): List<T>
dropWhile
Возвращает список, содержащий все элементы, кроме первых элементов, удовлетворяющих заданному
fun <T> Iterable<T>.dropWhile(
predicate: (T) -> Boolean
): List<T>
elementAtOrElse
Возвращает элемент по заданному , если
fun <T> Iterable<T>.elementAtOrElse(
index: Int,
defaultValue: (Int) -> T
): T
Возвращает элемент по заданному , если
fun <T> List<T>.elementAtOrElse(
index: Int,
defaultValue: (Int) -> T
): T
filter
Возвращает список, содержащий только элементы, соответствующие заданному
fun <T> Iterable<T>.filter(
predicate: (T) -> Boolean
): List<T>
filterIndexed
Возвращает список, содержащий только элементы, соответствующие заданному
fun <T> Iterable<T>.filterIndexed(
predicate: (index: Int, T) -> Boolean
): List<T>
filterIndexedTo
Добавляет все элементы, соответствующие заданному .
fun <T, C : MutableCollection<in T>> Iterable<T>.filterIndexedTo( destination: C, predicate: (index: Int, T) -> Boolean ): C
filterIsInstance
Возвращает список, содержащий все элементы, которые являются экземплярами указанного параметра типа R.
fun <R> Iterable<*>.filterIsInstance(): List<R>
filterIsInstanceTo
Добавляет все элементы, являющиеся экземплярами указанного параметра типа R, к заданному destination.
fun <R, C : MutableCollection<in R>> Iterable<*>.filterIsInstanceTo( destination: C ): C
filterNot
Возвращает список, содержащий все элементы, не соответствующие заданному predicate.
fun <T> Iterable<T>.filterNot( predicate: (T) -> Boolean ): List<T>
filterNotNull
Возвращает список, содержащий все элементы, которые не являются null.
fun <T : Any> Iterable<T?>.filterNotNull(): List<T>
filterNotNullTo
Добавляет все элементы, которые не являются null к заданному destination.
fun <C : MutableCollection<in T>, T : Any> Iterable<T?>.filterNotNullTo( destination: C ): C
filterNotTo
Добавляет все элементы, не соответствующие заданному predicate к заданному destination.
fun <T, C : MutableCollection<in T>> Iterable<T>.filterNotTo( destination: C, predicate: (T) -> Boolean ): C
filterTo
Добавляет все элементы, соответствующие заданному predicate к заданному destination.
fun <T, C : MutableCollection<in T>> Iterable<T>.filterTo( destination: C, predicate: (T) -> Boolean ): C
find
Возвращает первый элемент, соответствующий заданному predicate, или null если такой элемент не найден.
fun <T> Iterable<T>.find(predicate: (T) -> Boolean): T?
findLast
Возвращает последний элемент, соответствующий заданному predicate, или null если такой элемент не найден.
fun <T> Iterable<T>.findLast(predicate: (T) -> Boolean): T?
fun <T> List<T>.findLast(predicate: (T) -> Boolean): T?
first
Возвращает первый элемент, соответствующий заданному predicate.
fun <T> Iterable<T>.first(predicate: (T) -> Boolean): T
firstNotNullOf
Возвращает первое не null значение, полученное с помощью функции transform, применяемой к элементам этой коллекции в порядке итерации, или выбрасывает NoSuchElementException, если не было получено ни одного не null значения.
fun <T, R : Any> Iterable<T>.firstNotNullOf( transform: (T) -> R? ): R
firstNotNullOfOrNull
Возвращает первое не null значение, полученное с помощью функции transform, применяемой к элементам этой коллекции в порядке итерации, или null если не было получено ни одного не null значения.
fun <T, R : Any> Iterable<T>.firstNotNullOfOrNull( transform: (T) -> R? ): R?
firstOrNull
Возвращает первый элемент, соответствующий заданному predicate, или null если элемент не найден.
fun <T> Iterable<T>.firstOrNull( predicate: (T) -> Boolean ): T?
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>
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>
flatMapIndexedTo
Добавляет все элементы, полученные в результате вызова функции transform для каждого элемента и его индекса в исходной коллекции, в указанный destination.
fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapIndexedTo( destination: C, transform: (index: Int, T) -> Iterable<R> ): C
fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapIndexedTo( destination: C, transform: (index: Int, T) -> Sequence<R> ): C
flatMapTo
Добавляет все элементы, полученные в результате вызова функции transform для каждого элемента исходной коллекции, в указанный destination.
fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapTo( destination: C, transform: (T) -> Iterable<R> ): C
fun <T, R, C : MutableCollection<in R>> Iterable<T>.flatMapTo( destination: C, transform: (T) -> Sequence<R> ): C
flatten
Возвращает один список всех элементов из всех коллекций в данной коллекции.
fun <T> Iterable<Iterable<T>>.flatten(): List<T>
fold
foldIndexed
foldRight
foldRightIndexed
forEach
Выполняет заданное action для каждого элемента.
fun <T> Iterable<T>.forEach(action: (T) -> Unit)
forEachIndexed
Выполняет заданное action для каждого элемента, предоставляя порядковый индекс с элементом.
fun <T> Iterable<T>.forEachIndexed( action: (index: Int, T) -> Unit)
getOrElse
Возвращает элемент с заданным index или результат вызова функции defaultValue, если index находится за пределами этого списка.
fun <T> List<T>.getOrElse( index: Int, defaultValue: (Int) -> T ): T
getOrNull
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>>
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
groupingBy
Создаёт источник Grouping из коллекции для последующего использования с операциями группировки и сворачивания, используя указанную функцию keySelector для извлечения ключа из каждого элемента.
fun <T, K> Iterable<T>.groupingBy( keySelector: (T) -> K ): Grouping<T, K>
ifEmpty
Возвращает этот массив, если он не пуст, или результат вызова функции defaultValue, если массив пуст.
fun <C, R> C.ifEmpty( defaultValue: () -> R ): R where C : Array<*>, C : R
indexOf
Возвращает первый индекс элемента, или -1, если коллекция не содержит элемент.
fun <T> Iterable<T>.indexOf(element: T): Int
Возвращает первый индекс элемента, или -1, если список не содержит элемент.
fun <T> List<T>.indexOf(element: T): Int
indexOfFirst
Возвращает индекс первого элемента, соответствующего заданному предикату, или -1, если коллекция не содержит такой элемент.
fun <T> Iterable<T>.indexOfFirst( predicate: (T) -> Boolean ): Int
Возвращает индекс первого элемента, соответствующего заданному предикату, или -1, если список не содержит такой элемент.
fun <T> List<T>.indexOfFirst(predicate: (T) -> Boolean): Int
indexOfLast
Возвращает индекс последнего элемента, соответствующего заданному предикату, или -1, если коллекция не содержит такой элемент.
fun <T> Iterable<T>.indexOfLast( predicate: (T) -> Boolean ): Int
Возвращает индекс последнего элемента, соответствующего заданному предикату, или -1, если список не содержит такой элемент.
fun <T> List<T>.indexOfLast(predicate: (T) -> Boolean): Int
intersect
Возвращает множество, содержащее все элементы, которые содержатся как в этой коллекции, так и в указанной коллекции.
infix fun <T> Iterable<T>.intersect( other: Iterable<T> ): Set<T>
isNotEmpty
Возвращает true если коллекция не пуста.
fun <T> Collection<T>.isNotEmpty(): Boolean
isNullOrEmpty
Возвращает true если эта коллекция с типом Nullable равна null или пуста.
fun <T> Collection<T>?.isNullOrEmpty(): Boolean
joinTo
Добавляет строку из всех элементов, разделенных с помощью separator и с заданными prefix и postfix , если они указаны.
fun <T, A : Appendable> Iterable<T>.joinTo( buffer: A, separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: ((T) -> CharSequence)? = null ): A
joinToString
Создает строку из всех элементов, разделенных с помощью separator и с заданными prefix и postfix, если они указаны.
fun <T> Iterable<T>.joinToString( separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: ((T) -> CharSequence)? = null ): String
last
Возвращает последний элемент, соответствующий заданному предикату.
fun <T> Iterable<T>.last(predicate: (T) -> Boolean): T
fun <T> List<T>.last(predicate: (T) -> Boolean): T
lastIndexOf
Возвращает последний индекс элемента, или -1, если коллекция не содержит элемент.
fun <T> Iterable<T>.lastIndexOf(element: T): Int
Возвращает последний индекс элемента, или -1, если список не содержит элемент.
fun <T> List<T>.lastIndexOf(element: T): Int
lastOrNull
Возвращает последний элемент, соответствующий заданному предикату, или null если такой элемент не найден.
fun <T> Iterable<T>.lastOrNull(predicate: (T) -> Boolean): T?
fun <T> List<T>.lastOrNull(predicate: (T) -> Boolean): T?
map
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу в исходной коллекции.
fun <T, R> Iterable<T>.map(transform: (T) -> R): List<R>
mapIndexed
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу и его индексу в исходной коллекции.
fun <T, R> Iterable<T>.mapIndexed( transform: (index: Int, T) -> R ): List<R>
mapIndexedNotNull
Возвращает список, содержащий только результаты, не равные null, применения заданной функции преобразования к каждому элементу и его индексу в исходной коллекции.
fun <T, R : Any> Iterable<T>.mapIndexedNotNull( transform: (index: Int, T) -> R? ): List<R>
mapIndexedNotNullTo
Применяет заданную функцию преобразования к каждому элементу и его индексу в исходной коллекции и добавляет только результаты, не равные null, в заданное значение назначения.
fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapIndexedNotNullTo( destination: C, transform: (index: Int, T) -> R? ): C
mapIndexedTo
Применяет заданную функцию transform к каждому элементу и его индексу в исходной коллекции и добавляет результаты в указанный destination.
fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapIndexedTo( destination: C, transform: (index: Int, T) -> R ): C
mapNotNull
Возвращает список, содержащий только ненулевые результаты применения заданной функции transform к каждому элементу в исходной коллекции.
fun <T, R : Any> Iterable<T>.mapNotNull( transform: (T) -> R? ): List<R>
mapNotNullTo
Применяет заданную функцию transform к каждому элементу в исходной коллекции и добавляет только ненулевые результаты в указанный destination.
fun <T, R : Any, C : MutableCollection<in R>> Iterable<T>.mapNotNullTo( destination: C, transform: (T) -> R? ): C
mapTo
Применяет заданную функцию transform к каждому элементу исходной коллекции и добавляет результаты в указанный destination.
fun <T, R, C : MutableCollection<in R>> Iterable<T>.mapTo( destination: C, transform: (T) -> R ): C
maxByOrNull
Возвращает первый элемент, дающий наибольшее значение заданной функции, или null если элементов нет.
fun <T, R : Comparable<R>> Iterable<T>.maxByOrNull( selector: (T) -> R ): T?
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
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?
maxOfWith
Возвращает наибольшее значение в соответствии с предоставленным comparator среди всех значений, полученных с помощью функции selector, примененной к каждому элементу коллекции.
fun <T, R> Iterable<T>.maxOfWith( comparator: Comparator<in R>, selector: (T) -> R ): R
maxOfWithOrNull
Возвращает наибольшее значение в соответствии с предоставленным comparator среди всех значений, полученных с помощью функции selector, примененной к каждому элементу коллекции, или null если элементов нет.
fun <T, R> Iterable<T>.maxOfWithOrNull( comparator: Comparator<in R>, selector: (T) -> R ): R?
maxWith
Возвращает первый элемент, имеющий наибольшее значение в соответствии с предоставленным comparator.
fun <T> Iterable<T>.maxWith(comparator: Comparator<in T>): T
maxWithOrNull
Возвращает первый элемент, имеющий наибольшее значение в соответствии с предоставленным comparator, или null если элементов нет.
fun <T> Iterable<T>.maxWithOrNull( comparator: Comparator<in T> ): T?
minByOrNull
Возвращает первый элемент, дающий наименьшее значение заданной функции, или null если элементов нет.
fun <T, R : Comparable<R>> Iterable<T>.minByOrNull( selector: (T) -> R ): T?
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
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?
minOfWith
Возвращает наименьшее значение по предоставленному компаратору среди всех значений, полученных функцией selector, применённой к каждому элементу в коллекции.
fun <T, R> Iterable<T>.minOfWith( comparator: Comparator<in R>, selector: (T) -> R ): R
minOfWithOrNull
Возвращает наименьшее значение по предоставленному компаратору среди всех значений, полученных функцией selector, применённой к каждому элементу в коллекции, или null если элементов нет.
fun <T, R> Iterable<T>.minOfWithOrNull( comparator: Comparator<in R>, selector: (T) -> R ): R?
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>
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>)
minusElement
Возвращает список, содержащий все элементы исходной коллекции без первого вхождения данного элемента.
fun <T> Iterable<T>.minusElement(element: T): List<T>
minWith
Возвращает первый элемент с наименьшим значением по предоставленному компаратору.
fun <T> Iterable<T>.minWith(comparator: Comparator<in T>): T
minWithOrNull
Возвращает первый элемент с наименьшим значением по предоставленному компаратору или null если элементов нет.
fun <T> Iterable<T>.minWithOrNull( comparator: Comparator<in T> ): T?
none
Возвращает true если в коллекции нет элементов.
fun <T> Iterable<T>.none(): Boolean
Возвращает true если ни один элемент не соответствует заданному предикату.
fun <T> Iterable<T>.none(predicate: (T) -> Boolean): Boolean
onEach
Выполняет заданное действие для каждого элемента и возвращает саму коллекцию после выполнения.
fun <T, C : Iterable<T>> C.onEach(action: (T) -> Unit): C
onEachIndexed
Выполняет заданное действие для каждого элемента, предоставляя последовательный индекс с элементом, и возвращает саму коллекцию после выполнения.
fun <T, C : Iterable<T>> C.onEachIndexed( action: (index: Int, T) -> Unit ): C
partition
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>
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>)
plusElement
Возвращает список, содержащий все элементы исходной коллекции, а затем заданный элемент.
fun <T> Iterable<T>.plusElement(element: T): List<T>
fun <T> Collection<T>.plusElement(element: T): List<T>
random
Возвращает случайный элемент из этой коллекции.
fun <T> Collection<T>.random(): T
Возвращает случайный элемент из этой коллекции, используя указанный источник случайности.
fun <T> Collection<T>.random(random: Random): T
randomOrNull
Возвращает случайный элемент из этой коллекции, или null если эта коллекция пустая.
fun <T> Collection<T>.randomOrNull(): T?
Возвращает случайный элемент из этой коллекции, используя указанный источник случайности, или null если эта коллекция пустая.
fun <T> Collection<T>.randomOrNull(random: Random): T?
reduce
Накапливает значение, начиная с первого элемента и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу.
fun <S, T : S> Iterable<T>.reduce( operation: (acc: S, T) -> S ): S
reduceIndexed
Накапливает значение, начиная с первого элемента и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу с его индексом в исходном списке.
fun <S, T : S> Iterable<T>.reduceIndexed( operation: (index: Int, acc: S, T) -> S ): S
reduceIndexedOrNull
Накапливает значение, начиная с первого элемента и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу с его индексом в исходном списке.
fun <S, T : S> Iterable<T>.reduceIndexedOrNull( operation: (index: Int, acc: S, T) -> S ): S?
reduceOrNull
Накапливает значение, начиная с первого элемента и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу.
fun <S, T : S> Iterable<T>.reduceOrNull( operation: (acc: S, T) -> S ): S?
reduceRight
Накапливает значение, начиная с последнего элемента и применяя операцию справа налево к каждому элементу и текущему значению аккумулятора.
fun <S, T : S> List<T>.reduceRight( operation: (T, acc: S) -> S ): S
reduceRightIndexed
Накапливает значение, начиная с последнего элемента и применяя операцию справа налево к каждому элементу с его индексом в исходном списке и текущему значению аккумулятора.
fun <S, T : S> List<T>.reduceRightIndexed( operation: (index: Int, T, acc: S) -> S ): S
reduceRightIndexedOrNull
Накапливает значение, начиная с последнего элемента и применяя операцию справа налево к каждому элементу с его индексом в исходном списке и текущему значению аккумулятора.
fun <S, T : S> List<T>.reduceRightIndexedOrNull( operation: (index: Int, T, acc: S) -> S ): S?
reduceRightOrNull
Накапливает значение, начиная с последнего элемента и применяя операцию справа налево к каждому элементу и текущему значению аккумулятора.
fun <S, T : S> List<T>.reduceRightOrNull( operation: (T, acc: S) -> S ): S?
remove
Удаляет единственный экземпляр указанного элемента из этого набора, если он присутствует.
fun <T> MutableCollection<out T>.remove(element: T): Boolean
Удаляет элемент по указанному индексу из этого списка. В Kotlin следует использовать функцию MutableList.removeAt вместо этого.
fun <T> MutableList<T>.remove(index: Int): T
удалениевсех
Удаляет все элементы этой коллекции, которые также содержатся в указанной коллекции.
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
удалитьПервый
Удаляет первый элемент из этого изменяемого списка и возвращает удалённый элемент, или выбрасывает исключение если список пустой.
fun <T> MutableList<T>.removeFirst(): T
удалитьПервыйИлиNull
Удаляет первый элемент из этого изменяемого списка и возвращает удалённый элемент, или возвращает null если список пустой.
fun <T> MutableList<T>.removeFirstOrNull(): T?
удалитьПоследний
Удаляет последний элемент из этого изменяемого списка и возвращает удалённый элемент, или выбрасывает исключение если список пустой.
fun <T> MutableList<T>.removeLast(): T
удалитьПоследнийИлиNull
Удаляет последний элемент из этого изменяемого списка и возвращает удалённый элемент, или возвращает null если список пустой.
fun <T> MutableList<T>.removeLastOrNull(): T?
сохранитьВсе
Сохраняет только элементы в этой коллекции, которые содержатся в указанной коллекции.
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
обратный
Возвращает список с элементами в обратном порядке.
fun <T> Iterable<T>.reversed(): List<T>
последовательныйСкладывание
runningFoldIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу, его индексу в исходном списке и текущему значению накопителя, которое начинается со значения initial.
fun <T, R> Iterable<T>.runningFoldIndexed( initial: R, operation: (index: Int, acc: R, T) -> R ): List<R>
runningReduce
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу и текущему значению накопителя, которое начинается с первого элемента этого списка.
fun <S, T : S> Iterable<T>.runningReduce( operation: (acc: S, T) -> S ): List<S>
runningReduceIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу, его индексу в исходном списке и текущему значению накопителя, которое начинается с первого элемента этого списка.
fun <S, T : S> Iterable<T>.runningReduceIndexed( operation: (index: Int, acc: S, T) -> S ): List<S>
scan
scanIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путем применения операции слева направо к каждому элементу, его индексу в исходном списке и текущему значению накопителя, которое начинается со значения initial.
fun <T, R> Iterable<T>.scanIndexed( initial: R, operation: (index: Int, acc: R, T) -> R ): List<R>
shuffle
Случайным образом перемешивает элементы в этом списке на месте, используя указанный random экземпляр в качестве источника случайности.
fun <T> MutableList<T>.shuffle(random: Random)
shuffled
Возвращает новый список с элементами этого списка, случайным образом перемешанными с использованием указанного random экземпляра в качестве источника случайности.
fun <T> Iterable<T>.shuffled(random: Random): List<T>
single
Возвращает единственный элемент, соответствующий заданному предикату, или вызывает исключение, если такого элемента нет или их несколько.
fun <T> Iterable<T>.single(predicate: (T) -> Boolean): T
singleOrNull
Возвращает единственный элемент, соответствующий заданному предикату, или значение null , если элемент не найден или найдено более одного элемента.
fun <T> Iterable<T>.singleOrNull( predicate: (T) -> Boolean ): T?
slice
Возвращает список, содержащий элементы по индексам в указанном диапазоне индексов.
fun <T> List<T>.slice(indices: IntRange): List<T>
Возвращает список, содержащий элементы по указанным индексам.
fun <T> List<T>.slice(indices: Iterable<Int>): List<T>
sortBy
Сортирует элементы в списке на месте в соответствии с естественным порядком сортировки значения, возвращаемого заданной функцией selector.
fun <T, R : Comparable<R>> MutableList<T>.sortBy( selector: (T) -> R?)
sortByDescending
Сортирует элементы в списке на месте в порядке убывания в соответствии с естественным порядком сортировки значения, возвращаемого заданной функцией selector.
fun <T, R : Comparable<R>> MutableList<T>.sortByDescending( selector: (T) -> R?)
sortedBy
Возвращает список всех элементов, отсортированных в соответствии с естественным порядком сортировки значения, возвращаемого указанной функцией selector.
fun <T, R : Comparable<R>> Iterable<T>.sortedBy( selector: (T) -> R? ): List<T>
sortedByDescending
Возвращает список всех элементов, отсортированных в обратном порядке в соответствии с естественным порядком сортировки значения, возвращаемого указанной функцией selector.
fun <T, R : Comparable<R>> Iterable<T>.sortedByDescending( selector: (T) -> R? ): List<T>
sortedWith
Возвращает список всех элементов, отсортированных в соответствии с указанным comparator.
fun <T> Iterable<T>.sortedWith( comparator: Comparator<in T> ): List<T>
subtract
Возвращает множество, содержащее все элементы, которые содержатся в этой коллекции и не содержатся в указанной коллекции.
infix fun <T> Iterable<T>.subtract( other: Iterable<T> ): Set<T>
sumBy
Возвращает сумму всех значений, полученных с помощью функции selector, применённой к каждому элементу в коллекции.
fun <T> Iterable<T>.sumBy(selector: (T) -> Int): Int
sumByDouble
Возвращает сумму всех значений, полученных с помощью функции selector, применённой к каждому элементу в коллекции.
fun <T> Iterable<T>.sumByDouble( selector: (T) -> Double ): Double
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
take
Возвращает список, содержащий первые n элементов.
fun <T> Iterable<T>.take(n: Int): List<T>
takeLast
Возвращает список, содержащий последние n элементов.
fun <T> List<T>.takeLast(n: Int): List<T>
takeLastWhile
Возвращает список, содержащий последние элементы, удовлетворяющие указанному predicate.
fun <T> List<T>.takeLastWhile( predicate: (T) -> Boolean ): List<T>
takeWhile
Возвращает список, содержащий первые элементы, удовлетворяющие указанному predicate.
fun <T> Iterable<T>.takeWhile( predicate: (T) -> Boolean ): List<T>
toBooleanArray
Возвращает массив Boolean, содержащий все элементы этой коллекции.
fun Collection<Boolean>.toBooleanArray(): BooleanArray
toByteArray
Возвращает массив Byte, содержащий все элементы этой коллекции.
fun Collection<Byte>.toByteArray(): ByteArray
toCharArray
Возвращает массив Char, содержащий все элементы этой коллекции.
fun Collection<Char>.toCharArray(): CharArray
toCollection
Добавляет все элементы в указанную коллекцию destination.
fun <T, C : MutableCollection<in T>> Iterable<T>.toCollection( destination: C ): C
toDoubleArray
Возвращает массив Double, содержащий все элементы этой коллекции.
fun Collection<Double>.toDoubleArray(): DoubleArray
toFloatArray
Возвращает массив Float, содержащий все элементы этой коллекции.
fun Collection<Float>.toFloatArray(): FloatArray
toHashSet
Возвращает новый HashSet всех элементов.
fun <T> Iterable<T>.toHashSet(): HashSet<T>
toIntArray
Возвращает массив Int, содержащий все элементы этой коллекции.
fun Collection<Int>.toIntArray(): IntArray
toList
Возвращает List, содержащий все элементы.
fun <T> Iterable<T>.toList(): List<T>
toLongArray
Возвращает массив Long, содержащий все элементы этой коллекции.
fun Collection<Long>.toLongArray(): LongArray
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
toMutableSet
Возвращает новый MutableSet, содержащий все различные элементы из данной коллекции.
fun <T> Iterable<T>.toMutableSet(): MutableSet<T>
toSet
Возвращает Set всех элементов.
fun <T> Iterable<T>.toSet(): Set<T>
toShortArray
Возвращает массив Short, содержащий все элементы этой коллекции.
fun Collection<Short>.toShortArray(): ShortArray
toUByteArray
Возвращает массив UByte, содержащий все элементы этой коллекции.
fun Collection<UByte>.toUByteArray(): UByteArray
toUIntArray
Возвращает массив UInt, содержащий все элементы этой коллекции.
fun Collection<UInt>.toUIntArray(): UIntArray
toULongArray
Возвращает массив ULong, содержащий все элементы этой коллекции.
fun Collection<ULong>.toULongArray(): ULongArray
toUShortArray
Возвращает массив UShort, содержащий все элементы этой коллекции.
fun Collection<UShort>.toUShortArray(): UShortArray
union
Возвращает множество, содержащее все различные элементы из обеих коллекций.
infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T>
unzip
Возвращает пару списков, где первый список построен из первых значений каждой пары из этой коллекции, второй список построен из вторых значений каждой пары из этой коллекции.
fun <T, R> Iterable<Pair<T, R>>.unzip(): Pair<List<T>, List<R>>
windowed
Возвращает список снимков окна заданного size, скользящего по этой коллекции с заданным step, где каждый снимок является списком.
fun <T> Iterable<T>.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false ): List<List<T>>
Возвращает список результатов применения данной функции transform к каждому списку, представляющему собой представление окна заданного size, скользящего по этой коллекции с заданным step.
fun <T, R> Iterable<T>.windowed( size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (List<T>) -> R ): List<R>
withIndex
Возвращает ленивый Iterable, который оборачивает каждый элемент исходного набора в IndexedValue, содержащий индекс этого элемента и сам элемент.
fun <T> Iterable<T>.withIndex(): Iterable<IndexedValue<T>>
zip
Возвращает список пар, созданных из элементов this набора и массива other с тем же индексом. Возвращаемый список имеет длину самого короткого набора.
infix fun <T, R> Iterable<T>.zip( other: Array<out R> ): List<Pair<T, R>>
Возвращает список значений, созданных из элементов this набора и массива other с тем же индексом с использованием предоставленной функции transform, применённой к каждой паре элементов. Возвращаемый список имеет длину самого короткого набора.
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 с тем же индексом с использованием предоставленной функции transform, применённой к каждой паре элементов. Возвращаемый список имеет длину самого короткого набора.
fun <T, R, V> Iterable<T>.zip( other: Iterable<R>, transform: (a: T, b: R) -> V ): List<V>
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–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/-array-list/index.html