Массив
class Array<T>
Для Common, JVM, JS
Представляет массив (в частности, массив Java при нацеливании на платформу JVM). Экземпляры массивов можно создавать с помощью стандартных функций библиотеки arrayOf, arrayOfNulls и emptyArray. Дополнительную информацию об массивах см. в документации языка Kotlin.
Для Native
Представляет массив. Экземпляры массивов можно создавать с помощью конструктора, arrayOf, arrayOfNulls и emptyArray стандартных функций библиотеки. Дополнительную информацию об массивах см. в документации языка Kotlin.
Конструкторы
<init>
Создаёт новый массив заданного размера, где каждый элемент вычисляется путём вызова указанной функции init.
<init>(size: Int, init: (Int) -> T)
Свойства
size
Возвращает количество элементов в массиве.
val size: Int
Функции
get
Возвращает элемент массива по указанному индексу. Этот метод может вызываться с помощью оператора индексации.
operator fun get(index: Int): T
Расширяемые свойства
indices
Возвращает диапазон допустимых индексов для массива.
val <T> Array<out T>.indices: IntRange
последнийИндекс
Возвращает последний допустимый индекс для массива.
val <T> Array<out T>.lastIndex: Int
Расширяемые функции
all
Возвращает true если все элементы соответствуют заданному предикату.
fun <T> Array<out T>.all(predicate: (T) -> Boolean): Boolean
any
Возвращает true если массив содержит хотя бы один элемент.
fun <T> Array<out T>.any(): Boolean
Возвращает true если хотя бы один элемент соответствует заданному предикату.
fun <T> Array<out T>.any(predicate: (T) -> Boolean): Boolean
asIterable
Создаёт экземпляр Iterable, который оборачивает исходный массив, возвращая его элементы при итерации.
fun <T> Array<out T>.asIterable(): Iterable<T>
asSequence
Создаёт экземпляр Sequence, который оборачивает исходный массив, возвращая его элементы при итерации.
fun <T> Array<out T>.asSequence(): Sequence<T>
associate
associateBy
Возвращает Map, содержащую элементы из заданного массива, индексированные ключом, полученным из функции keySelector, применённой к каждому элементу.
fun <T, K> Array<out T>.associateBy( keySelector: (T) -> K ): Map<K, T>
Возвращает Map, содержащую значения, предоставленные функцией valueTransform, и индексированные функцией keySelector, применёнными к элементам заданного массива.
fun <T, K, V> Array<out T>.associateBy( keySelector: (T) -> K, valueTransform: (T) -> V ): Map<K, V>
associateByTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, применённой к каждому элементу заданного массива, а значением является сам элемент.
fun <T, K, M : MutableMap<in K, in T>> Array<out T>.associateByTo( destination: M, keySelector: (T) -> K ): M
Заполняет и возвращает изменяемую карту destination парами ключ-значение, где ключ предоставляется функцией keySelector, а значение предоставляется функцией valueTransform, применёнными к элементам заданного массива.
fun <T, K, V, M : MutableMap<in K, in V>> Array<out T>.associateByTo( destination: M, keySelector: (T) -> K, valueTransform: (T) -> V ): M
associateTo
Заполняет и возвращает изменяемую карту destination парами ключ-значение, предоставленными функцией transform, применённой к каждому элементу заданного массива.
fun <T, K, V, M : MutableMap<in K, in V>> Array<out T>.associateTo( destination: M, transform: (T) -> Pair<K, V> ): M
associateWith
Возвращает Map, где ключами являются элементы из заданного массива, а значениями — результат применения функции valueSelector к каждому элементу.
fun <K, V> Array<out K>.associateWith( valueSelector: (K) -> V ): Map<K, V>
associateWithTo
Заполняет и возвращает изменяемую карту назначения парами ключ-значение для каждого элемента заданного массива, где ключ — сам элемент, а значение — результат применения функции valueSelector к этому ключу.
fun <K, V, M : MutableMap<in K, in V>> Array<out K>.associateWithTo( destination: M, valueSelector: (K) -> V ): M
average
Возвращает среднее значение элементов в массиве.
fun Array<out Byte>.average(): Double
fun Array<out Short>.average(): Double
fun Array<out Int>.average(): Double
fun Array<out Long>.average(): Double
fun Array<out Float>.average(): Double
fun Array<out Double>.average(): Double
binarySearch
Ищет заданный элемент в массиве или в заданном диапазоне массива с помощью алгоритма бинарного поиска. Ожидается, что массив отсортирован по заданному компаратору, в противном случае результат не определен.
fun <T> Array<out T>.binarySearch( element: T, comparator: Comparator<in T>, fromIndex: Int = 0, toIndex: Int = size ): Int
Ищет заданный элемент в массиве или в заданном диапазоне массива с помощью алгоритма бинарного поиска. Ожидается, что массив отсортирован, в противном случае результат не определен.
fun <T> Array<out T>.binarySearch( element: T, fromIndex: Int = 0, toIndex: Int = size ): Int
component1
Возвращает первый элемент из массива.
operator fun <T> Array<out T>.component1(): T
component2
Возвращает второй элемент из массива.
operator fun <T> Array<out T>.component2(): T
component3
Возвращает третий элемент из массива.
operator fun <T> Array<out T>.component3(): T
component4
Возвращает четвёртый элемент из массива.
operator fun <T> Array<out T>.component4(): T
component5
Возвращает пятый элемент из массива.
operator fun <T> Array<out T>.component5(): T
contains
Возвращает true, если элемент найден в массиве.
operator fun <T> Array<out T>.contains(element: T): Boolean
count
Возвращает количество элементов в этом массиве.
fun <T> Array<out T>.count(): Int
Возвращает количество элементов, удовлетворяющих заданному предикату.
fun <T> Array<out T>.count(predicate: (T) -> Boolean): Int
distinct
Возвращает список, содержащий только уникальные элементы из заданного массива.
fun <T> Array<out T>.distinct(): List<T>
distinctBy
Возвращает список, содержащий только элементы из заданного массива с уникальными ключами, возвращаемыми заданной функцией селектора.
fun <T, K> Array<out T>.distinctBy( selector: (T) -> K ): List<T>
drop
Возвращает список, содержащий все элементы, кроме первых n элементов.
fun <T> Array<out T>.drop(n: Int): List<T>
dropLast
Возвращает список, содержащий все элементы, кроме последних n элементов.
fun <T> Array<out T>.dropLast(n: Int): List<T>
dropLastWhile
Возвращает список, содержащий все элементы, за исключением последних элементов, которые удовлетворяют заданному предикату.
fun <T> Array<out T>.dropLastWhile( predicate: (T) -> Boolean ): List<T>
dropWhile
Возвращает список, содержащий все элементы, за исключением первых элементов, которые удовлетворяют заданному предикату.
fun <T> Array<out T>.dropWhile( predicate: (T) -> Boolean ): List<T>
elementAtOrElse
Возвращает элемент с заданным индексом или результат вызова функции defaultValue, если индекс находится за пределами этого массива.
fun <T> Array<out T>.elementAtOrElse( index: Int, defaultValue: (Int) -> T ): T
elementAtOrNull
filter
Возвращает список, содержащий только элементы, соответствующие заданному предикату.
fun <T> Array<out T>.filter( predicate: (T) -> Boolean ): List<T>
filterIndexed
Возвращает список, содержащий только элементы, соответствующие заданному предикату.
fun <T> Array<out T>.filterIndexed( predicate: (index: Int, T) -> Boolean ): List<T>
filterIndexedTo
Добавляет все элементы, соответствующие заданному предикату, к заданному назначению.
fun <T, C : MutableCollection<in T>> Array<out T>.filterIndexedTo( destination: C, predicate: (index: Int, T) -> Boolean ): C
filterIsInstance
Возвращает список, содержащий все элементы, которые являются экземплярами указанного параметра типа R.
fun <R> Array<*>.filterIsInstance(): List<R>
Возвращает список, содержащий все элементы, которые являются экземплярами указанного класса.
fun <R> Array<*>.filterIsInstance(klass: Class<R>): List<R>
filterIsInstanceTo
Добавляет все элементы, которые являются экземплярами указанного параметра типа R, к заданному назначению.
fun <R, C : MutableCollection<in R>> Array<*>.filterIsInstanceTo( destination: C ): C
Добавляет все элементы, которые являются экземплярами указанного класса, к заданному назначению.
fun <C : MutableCollection<in R>, R> Array<*>.filterIsInstanceTo( destination: C, klass: Class<R> ): C
filterNot
Возвращает список, содержащий все элементы, не соответствующие заданному предикату.
fun <T> Array<out T>.filterNot( predicate: (T) -> Boolean ): List<T>
filterNotNull
Возвращает список, содержащий все элементы, которые не null.
fun <T : Any> Array<out T?>.filterNotNull(): List<T>
filterNotNullTo
Добавляет все элементы, которые не null, к заданному назначению.
fun <C : MutableCollection<in T>, T : Any> Array<out T?>.filterNotNullTo( destination: C ): C
filterNotTo
Добавляет все элементы, не соответствующие заданному .
fun <T, C : MutableCollection<in T>> Array<out T>.filterNotTo( destination: C, predicate: (T) -> Boolean ): C
filterTo
Добавляет все элементы, соответствующие заданному .
fun <T, C : MutableCollection<in T>> Array<out T>.filterTo( destination: C, predicate: (T) -> Boolean ): C
find
Возвращает первый элемент, соответствующий заданному
fun <T> Array<out T>.find(predicate: (T) -> Boolean): T?
findLast
Возвращает последний элемент, соответствующий заданному
fun <T> Array<out T>.findLast(predicate: (T) -> Boolean): T?
first
Возвращает первый элемент.
fun <T> Array<out T>.first(): T
Возвращает первый элемент, соответствующий заданному
fun <T> Array<out T>.first(predicate: (T) -> Boolean): T
firstNotNullOf
Возвращает первое значение, отличное от null, которое возвращает функция исключение NoSuchElementException, если не было произведено ни одного значения, отличного от null.
fun <T, R : Any> Array<out T>.firstNotNullOf( transform: (T) -> R? ): R
firstNotNullOfOrNull
Возвращает первое значение, отличное от null, которое возвращает функция
fun <T, R : Any> Array<out T>.firstNotNullOfOrNull(
transform: (T) -> R?
): R?
firstOrNull
Возвращает первый элемент, или null , если массив пуст.
fun <T> Array<out T>.firstOrNull(): T?
Возвращает первый элемент, соответствующий заданному
fun <T> Array<out T>.firstOrNull(
predicate: (T) -> Boolean
): T?
flatMap
Возвращает один список всех элементов, полученных из результатов функции
fun <T, R> any_array<T>.flatMap(
transform: (T) -> Iterable<R>
): List<R>
flatMapIndexed
Возвращает один список всех элементов, полученных из результатов функции
fun <T, R> any_array<T>.flatMapIndexed(
transform: (index: Int, T) -> Iterable<R>
): List<R>
flatMapIndexedTo
Добавляет все элементы, полученные из результатов функции .
fun <T, R, C : MutableCollection<in R>> any_array<T>.flatMapIndexedTo( destination: C, transform: (index: Int, T) -> Iterable<R> ): C
flatMapTo
Добавляет все элементы, полученные в результате вызова функции transform для каждого элемента исходного массива, в заданное место назначения.
fun <T, R, C : MutableCollection<in R>> any_array<T>.flatMapTo( destination: C, transform: (T) -> Iterable<R> ): C
flatten
Возвращает один список всех элементов из всех массивов в заданном массиве.
fun <T> Array<out Array<out T>>.flatten(): List<T>
fold
Накапливает значение, начиная со значения начального и применяя операцию operation слева направо к текущему значению накопителя и каждому элементу.
fun <T, R> Array<out T>.fold( initial: R, operation: (acc: R, T) -> R ): R
foldIndexed
Накапливает значение, начиная со значения начального и применяя операцию operation слева направо к текущему значению накопителя и каждому элементу с его индексом в исходном массиве.
fun <T, R> Array<out T>.foldIndexed( initial: R, operation: (index: Int, acc: R, T) -> R ): R
foldRight
Накапливает значение, начиная со значения начального и применяя операцию operation справа налево к каждому элементу и текущему значению накопителя.
fun <T, R> Array<out T>.foldRight( initial: R, operation: (T, acc: R) -> R ): R
foldRightIndexed
Накапливает значение, начиная со значения начального и применяя операцию operation справа налево к каждому элементу с его индексом в исходном массиве и текущему значению накопителя.
fun <T, R> Array<out T>.foldRightIndexed( initial: R, operation: (index: Int, T, acc: R) -> R ): R
forEach
Выполняет заданное действие action для каждого элемента.
fun <T> Array<out T>.forEach(action: (T) -> Unit)
forEachIndexed
Выполняет заданное действие action для каждого элемента, предоставляя последовательный индекс с элементом.
fun <T> Array<out T>.forEachIndexed( action: (index: Int, T) -> Unit)
getOrElse
Возвращает элемент по заданному индексу или результат вызова функции defaultValue, если индекс находится вне границ массива.
fun <T> Array<out T>.getOrElse( index: Int, defaultValue: (Int) -> T ): T
groupBy
Группирует элементы исходного массива по ключу, возвращаемому заданной функцией keySelector, применённой к каждому элементу, и возвращает карту, где каждый ключ группы связан со списком соответствующих элементов.
fun <T, K> Array<out T>.groupBy( keySelector: (T) -> K ): Map<K, List<T>>
Группирует значения, возвращаемые функцией valueTransform, применённой к каждому элементу исходного массива, по ключу, возвращаемому заданной функцией keySelector, применённой к элементу, и возвращает карту, где каждый ключ группы связан со списком соответствующих значений.
fun <T, K, V> Array<out T>.groupBy( keySelector: (T) -> K, valueTransform: (T) -> V ): Map<K, List<V>>
groupByTo
Группирует элементы исходного массива по ключу, возвращаемому заданной функцией keySelector, применённой к каждому элементу, и помещает в карту destination каждый ключ группы, связанный со списком соответствующих элементов.
fun <T, K, M : MutableMap<in K, MutableList<T>>> Array<out T>.groupByTo( destination: M, keySelector: (T) -> K ): M
Группирует значения, возвращаемые функцией valueTransform, применённой к каждому элементу исходного массива, по ключу, возвращаемому заданной функцией keySelector, применённой к элементу, и помещает в карту destination каждый ключ группы, связанный со списком соответствующих значений.
fun <T, K, V, M : MutableMap<in K, MutableList<V>>> Array<out T>.groupByTo( destination: M, keySelector: (T) -> K, valueTransform: (T) -> V ): M
groupingBy
Создаёт источник Grouping из массива для последующего использования с одной из операций группировки и свёртки с использованием указанной функции keySelector для извлечения ключа из каждого элемента.
fun <T, K> Array<out T>.groupingBy( keySelector: (T) -> K ): Grouping<T, K>
indexOf
Возвращает первый индекс element, или -1, если массив не содержит элемент.
fun <T> Array<out T>.indexOf(element: T): Int
indexOfFirst
Возвращает индекс первого элемента, удовлетворяющего заданному предикату predicate, или -1, если массив не содержит такого элемента.
fun <T> Array<out T>.indexOfFirst( predicate: (T) -> Boolean ): Int
indexOfLast
Возвращает индекс последнего элемента, удовлетворяющего заданному предикату predicate, или -1, если массив не содержит такого элемента.
fun <T> Array<out T>.indexOfLast( predicate: (T) -> Boolean ): Int
intersect
Возвращает множество, содержащее все элементы, которые содержатся как в этом массиве, так и в указанной коллекции.
infix fun <T> Array<out T>.intersect( other: Iterable<T> ): Set<T>
isArrayOf
Проверяет, может ли массив содержать элемент типа T.
fun <T : Any> Array<*>.isArrayOf(): Boolean
isEmpty
Возвращает true, если массив пуст.
fun <T> Array<out T>.isEmpty(): Boolean
isNotEmpty
Возвращает true, если массив не пуст.
fun <T> Array<out T>.isNotEmpty(): Boolean
isNullOrEmpty
Возвращает true, если этот допускающий значение NULL массив является либо NULL, либо пустым.
fun Array<*>?.isNullOrEmpty(): Boolean
joinTo
Добавляет строку из всех элементов, разделённых с помощью разделителя и с использованием заданного префикса и постфикса, если они указаны.
fun <T, A : Appendable> Array<out T>.joinTo( buffer: A, separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: ((T) -> CharSequence)? = null ): A
joinToString
Создаёт строку из всех элементов, разделённых с помощью разделителя и с использованием заданного префикса и постфикса, если они указаны.
fun <T> Array<out T>.joinToString( separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: ((T) -> CharSequence)? = null ): String
last
Возвращает последний элемент.
fun <T> Array<out T>.last(): T
Возвращает последний элемент, соответствующий заданному предикату.
fun <T> Array<out T>.last(predicate: (T) -> Boolean): T
lastIndexOf
Возвращает последний индекс элемента, или -1, если массив не содержит элемент.
fun <T> Array<out T>.lastIndexOf(element: T): Int
lastOrNull
Возвращает последний элемент, или null если массив пустой.
fun <T> Array<out T>.lastOrNull(): T?
Возвращает последний элемент, соответствующий заданному предикату, или null если такой элемент не был найден.
fun <T> Array<out T>.lastOrNull( predicate: (T) -> Boolean ): T?
map
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу в исходном массиве.
fun <T, R> Array<out T>.map(transform: (T) -> R): List<R>
mapIndexed
Возвращает список, содержащий результаты применения заданной функции преобразования к каждому элементу и его индексу в исходном массиве.
fun <T, R> Array<out T>.mapIndexed( transform: (index: Int, T) -> R ): List<R>
mapIndexedNotNull
Возвращает список, содержащий только результаты, отличные от null, применения заданной функции преобразования к каждому элементу и его индексу в исходном массиве.
fun <T, R : Any> Array<out T>.mapIndexedNotNull( transform: (index: Int, T) -> R? ): List<R>
mapIndexedNotNullTo
Применяет заданную функцию преобразования к каждому элементу и его индексу в исходном массиве и добавляет только результаты, отличные от null, в заданное назначение.
fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapIndexedNotNullTo( destination: C, transform: (index: Int, T) -> R? ): C
mapIndexedTo
Применяет заданную функцию преобразования к каждому элементу и его индексу в исходном массиве и добавляет результаты в заданное назначение.
fun <T, R, C : MutableCollection<in R>> Array<out T>.mapIndexedTo( destination: C, transform: (index: Int, T) -> R ): C
mapNotNull
Возвращает список, содержащий только те результаты, которые не равны null, полученные при применении заданной функции transform к каждому элементу исходного массива.
fun <T, R : Any> Array<out T>.mapNotNull( transform: (T) -> R? ): List<R>
mapNotNullTo
Применяет заданную функцию transform к каждому элементу исходного массива и добавляет только результаты, не равные null, в заданное место назначения .
fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapNotNullTo( destination: C, transform: (T) -> R? ): C
mapTo
Применяет заданную функцию transform к каждому элементу исходного массива и добавляет результаты в заданное место назначения .
fun <T, R, C : MutableCollection<in R>> Array<out T>.mapTo( destination: C, transform: (T) -> R ): C
maxByOrNull
Возвращает первый элемент, для которого заданная функция имеет наибольшее значение, или null если элементов нет.
fun <T, R : Comparable<R>> Array<out T>.maxByOrNull( selector: (T) -> R ): T?
maxOf
Возвращает наибольшее значение среди всех значений, полученных при применении функции selector к каждому элементу массива.
fun <T> any_array<T>.maxOf(selector: (T) -> Double): Double
maxOfOrNull
Возвращает наибольшее значение среди всех значений, полученных при применении функции selector к каждому элементу массива, или null если элементов нет.
fun <T> any_array<T>.maxOfOrNull( selector: (T) -> Double ): Double?
maxOfWith
Возвращает наибольшее значение согласно предоставленному компаратору среди всех значений, полученных при применении функции selector к каждому элементу массива.
fun <T, R> Array<out T>.maxOfWith( comparator: Comparator<in R>, selector: (T) -> R ): R
maxOfWithOrNull
Возвращает наибольшее значение согласно предоставленному компаратору среди всех значений, полученных при применении функции selector к каждому элементу массива, или null если элементов нет.
fun <T, R> Array<out T>.maxOfWithOrNull( comparator: Comparator<in R>, selector: (T) -> R ): R?
maxOrNull
Возвращает наибольший элемент или null если элементов нет.
fun <T : Comparable<T>> any_array<T>.maxOrNull(): T?
maxWith
Возвращает первый элемент с наибольшим значением согласно предоставленному компаратору.
fun <T> Array<out T>.maxWith(comparator: Comparator<in T>): T
fun <T> Array<out T>.maxWith( comparator: Comparator<in T> ): T?
maxWithOrNull
Возвращает первый элемент с наибольшим значением согласно предоставленному компаратору или null если элементов нет.
fun <T> Array<out T>.maxWithOrNull( comparator: Comparator<in T> ): T?
minByOrNull
Возвращает первый элемент, для которого заданная функция имеет наименьшее значение, или null если элементов нет.
fun <T, R : Comparable<R>> Array<out T>.minByOrNull( selector: (T) -> R ): T?
minOf
Возвращает наименьшее значение среди всех значений, полученных функцией selector, применённой к каждому элементу в массиве.
fun <T> any_array<T>.minOf(selector: (T) -> Double): Double
minOfOrNull
Возвращает наименьшее значение среди всех значений, полученных функцией selector, применённой к каждому элементу в массиве, или null , если элементов нет.
fun <T> any_array<T>.minOfOrNull( selector: (T) -> Double ): Double?
minOfWith
Возвращает наименьшее значение согласно предоставленному компаратору среди всех значений, полученных функцией selector, применённой к каждому элементу в массиве.
fun <T, R> Array<out T>.minOfWith( comparator: Comparator<in R>, selector: (T) -> R ): R
minOfWithOrNull
Возвращает наименьшее значение согласно предоставленному компаратору среди всех значений, полученных функцией selector, применённой к каждому элементу в массиве, или null , если элементов нет.
fun <T, R> Array<out T>.minOfWithOrNull( comparator: Comparator<in R>, selector: (T) -> R ): R?
minOrNull
Возвращает наименьший элемент или null , если элементов нет.
fun <T : Comparable<T>> any_array<T>.minOrNull(): T?
minWith
Возвращает первый элемент с наименьшим значением согласно предоставленному компаратору.
fun <T> Array<out T>.minWith(comparator: Comparator<in T>): T
fun <T> Array<out T>.minWith( comparator: Comparator<in T> ): T?
minWithOrNull
Возвращает первый элемент с наименьшим значением согласно предоставленному компаратору или null , если элементов нет.
fun <T> Array<out T>.minWithOrNull( comparator: Comparator<in T> ): T?
none
Возвращает true , если массив пуст.
fun <T> Array<out T>.none(): Boolean
Возвращает true , если ни один элемент не соответствует заданному предикату.
fun <T> Array<out T>.none(predicate: (T) -> Boolean): Boolean
onEach
Выполняет заданное действие над каждым элементом и возвращает сам массив после этого.
fun <T> Array<out T>.onEach( action: (T) -> Unit ): Array<out T>
onEachIndexed
Выполняет заданное действие над каждым элементом, предоставляя последовательный индекс с элементом, и возвращает сам массив после этого.
fun <T> Array<out T>.onEachIndexed( action: (index: Int, T) -> Unit ): Array<out T>
partition
random
Возвращает случайный элемент из этого массива.
fun <T> Array<out T>.random(): T
Возвращает случайный элемент из этого массива, используя указанный источник случайности.
fun <T> Array<out T>.random(random: Random): T
randomOrNull
Возвращает случайный элемент из этого массива или null если этот массив пуст.
fun <T> Array<out T>.randomOrNull(): T?
Возвращает случайный элемент из этого массива, используя указанный источник случайных чисел, или null если этот массив пуст.
fun <T> Array<out T>.randomOrNull(random: Random): T?
reduce
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению накопителя и каждому элементу.
fun <S, T : S> Array<out T>.reduce( operation: (acc: S, T) -> S ): S
reduceIndexed
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению накопителя и каждому элементу с его индексом в исходном массиве.
fun <S, T : S> Array<out T>.reduceIndexed( operation: (index: Int, acc: S, T) -> S ): S
reduceIndexedOrNull
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению накопителя и каждому элементу с его индексом в исходном массиве.
fun <S, T : S> Array<out T>.reduceIndexedOrNull( operation: (index: Int, acc: S, T) -> S ): S?
reduceOrNull
Накапливает значение, начиная с первого элемента и применяя operation слева направо к текущему значению накопителя и каждому элементу.
fun <S, T : S> Array<out T>.reduceOrNull( operation: (acc: S, T) -> S ): S?
reduceRight
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу и текущему значению накопителя.
fun <S, T : S> Array<out T>.reduceRight( operation: (T, acc: S) -> S ): S
reduceRightIndexed
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу с его индексом в исходном массиве и текущему значению накопителя.
fun <S, T : S> Array<out T>.reduceRightIndexed( operation: (index: Int, T, acc: S) -> S ): S
reduceRightIndexedOrNull
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу с его индексом в исходном массиве и текущему значению накопителя.
fun <S, T : S> Array<out T>.reduceRightIndexedOrNull( operation: (index: Int, T, acc: S) -> S ): S?
reduceRightOrNull
Накапливает значение, начиная с последнего элемента и применяя operation справа налево к каждому элементу и текущему значению накопителя.
fun <S, T : S> Array<out T>.reduceRightOrNull( operation: (T, acc: S) -> S ): S?
requireNoNulls
Возвращает исходную коллекцию, содержащую все не-null элементы, выбрасывая IllegalArgumentException если есть какие-либо null элементы.
fun <T : Any> Array<T?>.requireNoNulls(): Array<T>
reverse
Разворачивает элементы в массиве на месте.
fun <T> Array<T>.reverse()
Разворачивает элементы массива в указанном диапазоне на месте.
fun <T> Array<T>.reverse(fromIndex: Int, toIndex: Int)
reversed
Возвращает список с элементами в обратном порядке.
fun <T> Array<out T>.reversed(): List<T>
reversedArray
Возвращает массив с элементами этого массива в обратном порядке.
fun <T> Array<T>.reversedArray(): Array<T>
runningFold
runningFoldIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путём применения операции слева направо к каждому элементу, его индексу в исходном массиве и текущему значению аккумулятора, начинающемуся со значения initial.
fun <T, R> Array<out T>.runningFoldIndexed( initial: R, operation: (index: Int, acc: R, T) -> R ): List<R>
runningReduce
Возвращает список, содержащий последовательные значения накопления, полученные путём применения операции слева направо к каждому элементу и текущему значению аккумулятора, начинающемуся с первого элемента этого массива.
fun <S, T : S> Array<out T>.runningReduce( operation: (acc: S, T) -> S ): List<S>
runningReduceIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путём применения операции слева направо к каждому элементу, его индексу в исходном массиве и текущему значению аккумулятора, начинающемуся с первого элемента этого массива.
fun <S, T : S> Array<out T>.runningReduceIndexed( operation: (index: Int, acc: S, T) -> S ): List<S>
scan
scanIndexed
Возвращает список, содержащий последовательные значения накопления, полученные путём применения операции слева направо к каждому элементу, его индексу в исходном массиве и текущему значению аккумулятора, начинающемуся со значения initial.
fun <T, R> Array<out T>.scanIndexed( initial: R, operation: (index: Int, acc: R, T) -> R ): List<R>
shuffle
Случайным образом перемешивает элементы в этом массиве на месте.
fun <T> Array<T>.shuffle()
Случайным образом перемешивает элементы в этом массиве на месте, используя указанный random экземпляр в качестве источника случайности.
fun <T> Array<T>.shuffle(random: Random)
single
Возвращает единственный элемент или вызывает исключение, если массив пуст или содержит более одного элемента.
fun <T> Array<out T>.single(): T
Возвращает единственный элемент, соответствующий заданному предикату, или вызывает исключение, если нет или более одного соответствующего элемента.
fun <T> Array<out T>.single(predicate: (T) -> Boolean): T
singleOrNull
Возвращает единственный элемент или null , если массив пуст или содержит более одного элемента.
fun <T> Array<out T>.singleOrNull(): T?
Возвращает единственный элемент, соответствующий заданному предикату, или null , если элемент не найден или найдено более одного элемента.
fun <T> Array<out T>.singleOrNull( predicate: (T) -> Boolean ): T?
slice
Возвращает список, содержащий элементы в указанном диапазоне индексов.
fun <T> Array<out T>.slice(indices: IntRange): List<T>
Возвращает список, содержащий элементы по указанным индексам.
fun <T> Array<out T>.slice(indices: Iterable<Int>): List<T>
sliceArray
Возвращает массив, содержащий элементы этого массива по указанным индексам.
fun <T> Array<T>.sliceArray( indices: Collection<Int> ): Array<T>
Возвращает массив, содержащий элементы по индексам в указанном диапазоне индексов.
fun <T> Array<T>.sliceArray(indices: IntRange): Array<T>
sort
Сортирует массив на месте в соответствии с порядком, заданным данной функцией сравнения.
fun <T> Array<out T>.sort(comparison: (a: T, b: T) -> Int)
sortBy
Сортирует элементы массива на месте в соответствии с естественным порядком сортировки значения, возвращаемого указанной функцией селектора.
fun <T, R : Comparable<R>> Array<out T>.sortBy( selector: (T) -> R?)
sortByDescending
Сортирует элементы массива на месте в обратном порядке в соответствии с естественным порядком сортировки значения, возвращаемого указанной функцией селектора.
fun <T, R : Comparable<R>> Array<out T>.sortByDescending( selector: (T) -> R?)
sortDescending
Сортирует элементы массива на месте в обратном порядке в соответствии с их естественным порядком сортировки.
fun <T : Comparable<T>> Array<out T>.sortDescending()
Сортирует элементы массива в указанном диапазоне на месте. Элементы сортируются в обратном порядке в соответствии с их естественным порядком сортировки.
fun <T : Comparable<T>> Array<out T>.sortDescending( fromIndex: Int, toIndex: Int)
sorted
Возвращает список всех отсортированных элементов в соответствии с их естественным порядком сортировки.
fun <T : Comparable<T>> Array<out T>.sorted(): List<T>
sortedArray
Возвращает массив со всеми элементами этого массива, отсортированными в соответствии с их естественным порядком сортировки.
fun <T : Comparable<T>> Array<T>.sortedArray(): Array<T>
sortedArrayDescending
Возвращает массив со всеми элементами этого массива, отсортированными в обратном порядке в соответствии с их естественным порядком сортировки.
fun <T : Comparable<T>> Array<T>.sortedArrayDescending(): Array<T>
sortedArrayWith
Возвращает массив со всеми элементами этого массива, отсортированными в соответствии с указанным компаратором.
fun <T> Array<out T>.sortedArrayWith( comparator: Comparator<in T> ): Array<out T>
sortedBy
Возвращает список всех элементов, отсортированных в соответствии с естественным порядком сортировки значения, возвращаемого указанной функцией селектора.
fun <T, R : Comparable<R>> Array<out T>.sortedBy( selector: (T) -> R? ): List<T>
sortedByDescending
Возвращает список всех элементов, отсортированных в обратном порядке в соответствии с естественным порядком сортировки значения, возвращаемого указанной функцией селектора.
fun <T, R : Comparable<R>> Array<out T>.sortedByDescending( selector: (T) -> R? ): List<T>
sortedDescending
Возвращает список всех элементов, отсортированных в обратном порядке в соответствии с их естественным порядком сортировки.
fun <T : Comparable<T>> Array<out T>.sortedDescending(): List<T>
sortedWith
Возвращает список всех элементов, отсортированных в соответствии с указанным компаратором.
fun <T> Array<out T>.sortedWith( comparator: Comparator<in T> ): List<T>
sortWith
Сортирует массив на месте в соответствии с порядком, заданным данным компаратором.
fun <T> Array<out T>.sortWith(comparator: Comparator<in T>)
Сортирует диапазон в массиве на месте с данным компаратором.
fun <T> Array<out T>.sortWith( comparator: Comparator<in T>, fromIndex: Int = 0, toIndex: Int = size)
subtract
Возвращает множество, содержащее все элементы, которые содержатся в этом массиве и не содержатся в указанном наборе.
infix fun <T> Array<out T>.subtract( other: Iterable<T> ): Set<T>
sum
Возвращает сумму всех элементов в массиве.
fun Array<out Byte>.sum(): Int
fun Array<out Short>.sum(): Int
fun Array<out Int>.sum(): Int
fun Array<out Long>.sum(): Long
fun Array<out Float>.sum(): Float
fun Array<out Double>.sum(): Double
fun Array<out UInt>.sum(): UInt
fun Array<out ULong>.sum(): ULong
fun Array<out UByte>.sum(): UInt
fun Array<out UShort>.sum(): UInt
sumBy
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу в массиве.
fun <T> Array<out T>.sumBy(selector: (T) -> Int): Int
sumByDouble
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу в массиве.
fun <T> Array<out T>.sumByDouble( selector: (T) -> Double ): Double
sumOf
Возвращает сумму всех значений, полученных функцией selector, применённой к каждому элементу в массиве.
fun <T> any_array<T>.sumOf(selector: (T) -> Double): Double
take
Возвращает список, содержащий первые n элементов.
fun <T> Array<out T>.take(n: Int): List<T>
takeLast
Возвращает список, содержащий последние n элементов.
fun <T> Array<out T>.takeLast(n: Int): List<T>
takeLastWhile
Возвращает список, содержащий последние элементы, удовлетворяющие заданному предикату.
fun <T> Array<out T>.takeLastWhile( predicate: (T) -> Boolean ): List<T>
takeWhile
Возвращает список, содержащий первые элементы, удовлетворяющие заданному предикату.
fun <T> Array<out T>.takeWhile( predicate: (T) -> Boolean ): List<T>
toBooleanArray
Возвращает массив Boolean, содержащий все элементы этого универсального массива.
fun Array<out Boolean>.toBooleanArray(): BooleanArray
toByteArray
Возвращает массив Byte, содержащий все элементы этого универсального массива.
fun Array<out Byte>.toByteArray(): ByteArray
toCharArray
Возвращает массив Char, содержащий все элементы этого универсального массива.
fun Array<out Char>.toCharArray(): CharArray
toCollection
Добавляет все элементы в заданное назначенное множество.
fun <T, C : MutableCollection<in T>> Array<out T>.toCollection( destination: C ): C
toCStringArray
Преобразовать этот массив строк Kotlin в массив C строк C, выделив память для массива и строк C с заданным AutofreeScope.
fun Array<String>.toCStringArray( autofreeScope: AutofreeScope ): CPointer<CPointerVar<ByteVar>>
toCValues
fun <T : CPointed> Array<CPointer<T>?>.toCValues(): CValues<CPointerVar<T>>
toDoubleArray
Возвращает массив Double, содержащий все элементы этого универсального массива.
fun Array<out Double>.toDoubleArray(): DoubleArray
toFloatArray
Возвращает массив Float, содержащий все элементы этого универсального массива.
fun Array<out Float>.toFloatArray(): FloatArray
toHashSet
Возвращает новый HashSet всех элементов.
fun <T> Array<out T>.toHashSet(): HashSet<T>
toIntArray
Возвращает массив Int, содержащий все элементы этого универсального массива.
fun Array<out Int>.toIntArray(): IntArray
toList
Возвращает List, содержащий все элементы.
fun <T> Array<out T>.toList(): List<T>
toLongArray
Возвращает массив Long, содержащий все элементы этого универсального массива.
fun Array<out Long>.toLongArray(): LongArray
toMap
Возвращает новую карту, содержащую все пары ключ-значение из данного массива пар.
fun <K, V> Array<out Pair<K, V>>.toMap(): Map<K, V>
Заполняет и возвращает изменяемую карту destination парами ключ-значение из данного массива пар.
fun <K, V, M : MutableMap<in K, in V>> Array<out Pair<K, V>>.toMap( destination: M ): M
toMutableList
Возвращает новый MutableList, заполненный всеми элементами этого массива.
fun <T> Array<out T>.toMutableList(): MutableList<T>
toMutableSet
Возвращает новый MutableSet, содержащий все различные элементы из данного массива.
fun <T> Array<out T>.toMutableSet(): MutableSet<T>
toSet
Возвращает Set всех элементов.
fun <T> Array<out T>.toSet(): Set<T>
toShortArray
Возвращает массив Short, содержащий все элементы этого универсального массива.
fun Array<out Short>.toShortArray(): ShortArray
toSortedSet
Возвращает новый SortedSet всех элементов.
fun <T : Comparable<T>> any_array<T>.toSortedSet(): SortedSet<T>
toUByteArray
Возвращает массив UByte, содержащий все элементы этого универсального массива.
fun Array<out UByte>.toUByteArray(): UByteArray
toUIntArray
Возвращает массив UInt, содержащий все элементы этого универсального массива.
fun Array<out UInt>.toUIntArray(): UIntArray
toULongArray
Возвращает массив ULong, содержащий все элементы этого универсального массива.
fun Array<out ULong>.toULongArray(): ULongArray
toUShortArray
Возвращает массив UShort, содержащий все элементы этого универсального массива.
fun Array<out UShort>.toUShortArray(): UShortArray
union
Возвращает множество, содержащее все различные элементы из обеих коллекций.
infix fun <T> Array<out T>.union(other: Iterable<T>): Set<T>
unzip
Возвращает пару списков, где первый список построен из первых значений каждой пары из этого массива, второй список построен из вторых значений каждой пары из этого массива.
fun <T, R> Array<out Pair<T, R>>.unzip(): Pair<List<T>, List<R>>
withIndex
Возвращает ленивый Iterable, который оборачивает каждый элемент исходного массива в IndexedValue, содержащий индекс этого элемента и сам элемент.
fun <T> Array<out T>.withIndex(): Iterable<IndexedValue<T>>
zip
Возвращает список пар, созданных из элементов массива this и массива other с тем же индексом. Возвращаемый список имеет длину самого короткого набора.
infix fun <T, R> Array<out T>.zip( other: Array<out R> ): List<Pair<T, R>>
Возвращает список значений, созданных из элементов массива this и массива other с тем же индексом, используя предоставленную функцию transform, примененную к каждой паре элементов. Возвращаемый список имеет длину самого короткого набора.
fun <T, R, V> Array<out T>.zip( other: Array<out R>, transform: (a: T, b: R) -> V ): List<V>
Возвращает список пар, созданных из элементов this коллекции и массива other с тем же индексом. Возвращаемый список имеет длину самого короткого набора.
infix fun <T, R> Array<out T>.zip( other: Iterable<R> ): List<Pair<T, R>>
Возвращает список значений, созданных из элементов массива this и коллекции other с тем же индексом, используя предоставленную функцию transform, примененную к каждой паре элементов. Возвращаемый список имеет длину самого короткого набора.
fun <T, R, V> Array<out T>.zip( other: Iterable<R>, transform: (a: T, b: R) -> V ): List<V>
© 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/-array/index.html