Array

Требования к платформе и версии: Общая (1.0)

expect class Array<T>

Обобщённый массив объектов. При компиляции для JVM экземпляры этого класса представлены как T[]. Экземпляры массивов можно создавать с помощью стандартных библиотечных функций arrayOf, arrayOfNulls и emptyArray.

Дополнительную информацию о массивах см. в документации по языку Kotlin.

Требования к платформе и версии: JS (1.1), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual class Array<T>

Обобщённый массив объектов. Экземпляры массивов можно создавать с помощью стандартных библиотечных функций arrayOf, arrayOfNulls и emptyArray.

Дополнительную информацию о массивах см. в документации по языку Kotlin.

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

actual class Array<T>

Обобщённый массив объектов. Экземпляры этого класса представлены как T[]. Экземпляры массивов можно создавать с помощью стандартных библиотечных функций arrayOf, arrayOfNulls и emptyArray.

Дополнительную информацию о массивах см. в документации по языку Kotlin.

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

Array

expect constructor(size: Int, init: (Int) -> T)

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

Свойства

indices

Требования к платформе и версии: Общая (1.0)

val <T> Array<out T>.indices: IntRange

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

lastIndex

Требования к платформе и версии: Общая (1.0)

val <T> Array<out T>.lastIndex: Int

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

length

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


@ExperimentalWasmJsInterop
actual val JsArray<*>.length: Int

size

Требования к платформе и версии: Общая (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect val size: Int

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

Функции

all

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

inline fun <T> Array<out T>.all(predicate: (T) -> Boolean): Boolean

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

allDistinct

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


@ExperimentalStdlibApi
fun <T> Array<out T>.allDistinct(): Boolean

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

allDistinctBy

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


@ExperimentalStdlibApi
inline fun <T, K> Array<out T>.allDistinctBy(selector: (T) -> K): Boolean

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

allEqual

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


@ExperimentalStdlibApi
fun <T> Array<out T>.allEqual(): Boolean

Возвращает true, если все элементы массива равны друг другу.

allEqualBy

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


@ExperimentalStdlibApi
inline fun <T, K> Array<out T>.allEqualBy(selector: (T) -> K): Boolean

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

any

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

fun <T> Array<out T>.any(): Boolean

Возвращает true, если массив содержит хотя бы один элемент.

inline fun <T> Array<out T>.any(predicate: (T) -> Boolean): Boolean

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

asIterable

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

fun <T> Array<out T>.asIterable(): Iterable<T>

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

asList

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> Array<out T>.asList(): List<T>

Возвращает List, оборачивающий исходный массив.

asSequence

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

fun <T> Array<out T>.asSequence(): Sequence<T>

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

associate

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

inline fun <T, K, V> Array<out T>.associate(transform: (T) -> Pair<K, V>): Map<K, V>

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

associateBy

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

inline fun <T, K> Array<out T>.associateBy(keySelector: (T) -> K): Map<K, T>

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

inline fun <T, K, V> Array<out T>.associateBy(keySelector: (T) -> K, valueTransform: (T) -> V): Map<K, V>

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

associateByTo

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


@IgnorableReturnValue
inline fun <T, K, M : MutableMap<in K, in T>> Array<out T>.associateByTo(destination: M, keySelector: (T) -> K): M

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


@IgnorableReturnValue
inline fun <T, K, V, M : MutableMap<in K, in V>> Array<out T>.associateByTo(destination: M, keySelector: (T) -> K, valueTransform: (T) -> V): M

Заполняет изменяемую карту назначения парами «ключ-значение» и возвращает ее. Ключ предоставляется функцией keySelector, а значение — функцией valueTransform, примененными к элементам заданного массива.

associateTo

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


@IgnorableReturnValue
inline fun <T, K, V, M : MutableMap<in K, in V>> Array<out T>.associateTo(destination: M, transform: (T) -> Pair<K, V>): M

Заполняет изменяемую карту назначения парами «ключ-значение», предоставленными функцией transform, примененной к каждому элементу заданного массива, и возвращает ее.

associateWith

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

inline fun <K, V> Array<out K>.associateWith(valueSelector: (K) -> V): Map<K, V>

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

associateWithTo

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


@IgnorableReturnValue
inline fun <K, V, M : MutableMap<in K, in V>> Array<out K>.associateWithTo(destination: M, valueSelector: (K) -> V): M

Заполняет изменяемую карту назначения парами «ключ-значение» для каждого элемента заданного массива и возвращает ее. Ключом является сам элемент, а значение предоставляется функцией valueSelector, примененной к этому ключу.

average

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


@JvmName(name = "averageOfByte")
fun Array<out Byte>.average(): Double


@JvmName(name = "averageOfDouble")
fun Array<out Double>.average(): Double


@JvmName(name = "averageOfFloat")
fun Array<out Float>.average(): Double


@JvmName(name = "averageOfInt")
fun Array<out Int>.average(): Double


@JvmName(name = "averageOfLong")
fun Array<out Long>.average(): Double


@JvmName(name = "averageOfShort")
fun Array<out Short>.average(): Double

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

binarySearch

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

fun <T> Array<out T>.binarySearch(element: T, fromIndex: Int = 0, toIndex: Int = size): Int

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

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

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

component1

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

inline operator fun <T> Array<out T>.component1(): T

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

component2

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

inline operator fun <T> Array<out T>.component2(): T

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

component3

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

inline operator fun <T> Array<out T>.component3(): T

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

component4

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

inline operator fun <T> Array<out T>.component4(): T

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

component5

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

inline operator fun <T> Array<out T>.component5(): T

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

contains

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

operator fun <T> Array<out T>.contains(element: T): Boolean

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

contentDeepEquals

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

expect infix fun <T> Array<out T>.contentDeepEquals(other: Array<out T>): Boolean

Проверяет, являются ли два заданных массива глубоко равными.

expect infix fun <T> Array<out T>?.contentDeepEquals(other: Array<out T>?): Boolean

Проверяет, являются ли два заданных массива глубоко равными.

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


@JvmName(name = "contentDeepEqualsInline")
actual infix inline fun <T> Array<out T>.contentDeepEquals(other: Array<out T>): Boolean

Проверяет, являются ли два заданных массива глубоко равными.


@JvmName(name = "contentDeepEqualsNullable")
actual infix inline fun <T> Array<out T>?.contentDeepEquals(other: Array<out T>?): Boolean

Проверяет, являются ли два заданных массива глубоко равными.

Требования к платформе и версии: Wasm-JS (1.8), Wasm-WASI (1.8)

actual infix fun <T> Array<out T>.contentDeepEquals(other: Array<out T>): Boolean

actual infix fun <T> Array<out T>?.contentDeepEquals(other: Array<out T>?): Boolean

Проверяет, являются ли два заданных массива глубоко равными.

contentDeepHashCode

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

expect fun <T> Array<out T>.contentDeepHashCode(): Int

Возвращает хеш-код, основанный на содержимом этого массива, как если бы он был List. Вложенные массивы также рассматриваются как списки.

expect fun <T> Array<out T>?.contentDeepHashCode(): Int

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


@JvmName(name = "contentDeepHashCodeInline")
actual inline fun <T> Array<out T>.contentDeepHashCode(): Int


@JvmName(name = "contentDeepHashCodeNullable")
actual inline fun <T> Array<out T>?.contentDeepHashCode(): Int

Требования к платформе и версии: Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun <T> Array<out T>.contentDeepHashCode(): Int

actual fun <T> Array<out T>?.contentDeepHashCode(): Int

contentDeepToString

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

expect fun <T> Array<out T>.contentDeepToString(): String

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

expect fun <T> Array<out T>?.contentDeepToString(): String

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


@JvmName(name = "contentDeepToStringInline")
actual inline fun <T> Array<out T>.contentDeepToString(): String


@JvmName(name = "contentDeepToStringNullable")
actual inline fun <T> Array<out T>?.contentDeepToString(): String

Требования к платформе и версии: Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun <T> Array<out T>.contentDeepToString(): String

actual fun <T> Array<out T>?.contentDeepToString(): String

contentEquals

Требования к платформе и версии: Common (1.4), JS (1.4), Native (1.4), Wasm-JS (1.8), Wasm-WASI (1.8)

expect infix fun <T> Array<out T>?.contentEquals(other: Array<out T>?): Boolean

Проверяет, являются ли два заданных массива структурно равными.

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

actual infix inline fun <T> Array<out T>?.contentEquals(other: Array<out T>?): Boolean

Проверяет, являются ли два заданных массива структурно равными.

contentHashCode

Требования к платформе и версии: Common (1.4), JS (1.4), Native (1.4), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> Array<out T>?.contentHashCode(): Int

Возвращает хеш-код, основанный на содержимом этого массива, как если бы он был List.

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

actual inline fun <T> Array<out T>?.contentHashCode(): Int

Возвращает хеш-код, основанный на содержимом этого массива, как если бы он был List.

contentToString

Требования к платформе и версии: Common (1.4), JS (1.4), Native (1.4), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> Array<out T>?.contentToString(): String

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

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

actual inline fun <T> Array<out T>?.contentToString(): String

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

copyInto

Требования к платформе и версии: Common (1.3), JVM (1.3), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)


@IgnorableReturnValue
expect fun <T> Array<out T>.copyInto(destination: Array<T>, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = size): Array<T>

Копирует этот массив или его поддиапазон в массив назначения и возвращает этот массив.

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


@IgnorableReturnValue
actual inline fun <T> Array<out T>.copyInto(destination: Array<T>, destinationOffset: Int = 0, startIndex: Int = 0, endIndex: Int = size): Array<T>

Копирует этот массив или его поддиапазон в массив назначения и возвращает этот массив.

copyOf

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

expect fun <T> Array<T>.copyOf(): Array<T>

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

expect fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

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


@ExperimentalStdlibApi
inline fun <T> Array<T>.copyOf(newSize: Int, init: (Int) -> T): Array<T>

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

inline fun <T> Array<out T>.copyOf(): Array<T>

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

fun <T> Array<out T>.copyOf(newSize: Int): Array<T?>

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

actual inline fun <T> Array<T>.copyOf(): Array<T>

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

actual inline fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

Требования к платформе и версии: Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual fun <T> Array<T>.copyOf(): Array<T>

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

actual fun <T> Array<T>.copyOf(newSize: Int): Array<T?>

copyOfRange

Требования к платформе и версии: Common (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> Array<T>.copyOfRange(fromIndex: Int, toIndex: Int): Array<T>

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

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

fun <T> Array<out T>.copyOfRange(fromIndex: Int, toIndex: Int): Array<T>

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

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


@JvmName(name = "copyOfRangeInline")
actual inline fun <T> Array<T>.copyOfRange(fromIndex: Int, toIndex: Int): Array<T>

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

count

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

inline fun <T> Array<out T>.count(): Int

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

inline fun <T> Array<out T>.count(predicate: (T) -> Boolean): Int

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

distinct

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

fun <T> Array<out T>.distinct(): List<T>

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

distinctBy

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

inline fun <T, K> Array<out T>.distinctBy(selector: (T) -> K): List<T>

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

drop

Платформы и требования к версиям: Common (1.0)

fun <T> Array<out T>.drop(n: Int): List<T>

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

dropLast

Платформы и требования к версиям: Common (1.0)

fun <T> Array<out T>.dropLast(n: Int): List<T>

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

dropLastWhile

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.dropLastWhile(predicate: (T) -> Boolean): List<T>

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

dropWhile

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.dropWhile(predicate: (T) -> Boolean): List<T>

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

elementAt

Платформы и требования к версиям: Common (1.0), JS (1.1)

expect fun <T> Array<out T>.elementAt(index: Int): T

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

Платформы и требования к версиям: JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

actual inline fun <T> Array<out T>.elementAt(index: Int): T

elementAtOrElse

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.elementAtOrElse(index: Int, defaultValue: (Int) -> T): T

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

elementAtOrNull

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.elementAtOrNull(index: Int): T?

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

fill

Платформы и требования к версиям: Common (1.3), JS (1.3), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> Array<T>.fill(element: T, fromIndex: Int = 0, toIndex: Int = size)

Заполняет этот массив или его поддиапазон указанным значением element.

filter

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.filter(predicate: (T) -> Boolean): List<T>

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

filterIndexed

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.filterIndexed(predicate: (index: Int, T) -> Boolean): List<T>

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

filterIndexedTo

Платформы и требования к версиям: Common (1.0)


@IgnorableReturnValue
inline fun <T, C : MutableCollection<in T>> Array<out T>.filterIndexedTo(destination: C, predicate: (index: Int, T) -> Boolean): C

Добавляет все элементы, соответствующие заданному predicate, в указанный destination.

filterIsInstance

Платформы и требования к версиям: Common (1.0)

inline fun <R> Array<*>.filterIsInstance(): List<R>

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

Платформы и требования к версиям: JVM (1.0)

fun <R> Array<*>.filterIsInstance(klass: Class<R>): List<R>

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

filterIsInstanceTo

Платформы и требования к версиям: Common (1.0)


@IgnorableReturnValue
inline fun <R, C : MutableCollection<in R>> Array<*>.filterIsInstanceTo(destination: C): C

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

Платформы и требования к версиям: JVM (1.0)


@IgnorableReturnValue
fun <C : MutableCollection<in R>, R> Array<*>.filterIsInstanceTo(destination: C, klass: Class<R>): C

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

filterNot

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.filterNot(predicate: (T) -> Boolean): List<T>

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

filterNotNull

Платформы и требования к версиям: Common (1.0)

fun <T : Any> Array<out T?>.filterNotNull(): List<T>

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

filterNotNullTo

Платформы и требования к версиям: Common (1.0)


@IgnorableReturnValue
fun <C : MutableCollection<in T>, T : Any> Array<out T?>.filterNotNullTo(destination: C): C

Добавляет все элементы, которые не являются null, в указанный destination.

filterNotTo

Платформы и требования к версиям: Common (1.0)


@IgnorableReturnValue
inline fun <T, C : MutableCollection<in T>> Array<out T>.filterNotTo(destination: C, predicate: (T) -> Boolean): C

Добавляет все элементы, не соответствующие заданному predicate, в указанный destination.

filterTo

Платформы и требования к версиям: Common (1.0)


@IgnorableReturnValue
inline fun <T, C : MutableCollection<in T>> Array<out T>.filterTo(destination: C, predicate: (T) -> Boolean): C

Добавляет все элементы, соответствующие заданному predicate, в указанный destination.

find

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.find(predicate: (T) -> Boolean): T?

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

findLast

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.findLast(predicate: (T) -> Boolean): T?

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

first

Платформы и требования к версиям: Common (1.0)

fun <T> Array<out T>.first(): T

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

inline fun <T> Array<out T>.first(predicate: (T) -> Boolean): T

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

firstNotNullOf

Платформы и требования к версиям: Common (1.5)

inline fun <T, R : Any> Array<out T>.firstNotNullOf(transform: (T) -> R?): R

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

firstNotNullOfOrNull

Платформы и требования к версиям: Common (1.5)

inline fun <T, R : Any> Array<out T>.firstNotNullOfOrNull(transform: (T) -> R?): R?

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

firstOrNull

Платформы и требования к версиям: Common (1.0)

fun <T> Array<out T>.firstOrNull(): T?

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

inline fun <T> Array<out T>.firstOrNull(predicate: (T) -> Boolean): T?

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

flatMap

Платформы и требования к версиям: Common (1.0)

inline fun <T, R> Array<out T>.flatMap(transform: (T) -> Iterable<R>): List<R>

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


@JvmName(name = "flatMapSequence")
inline fun <T, R> Array<out T>.flatMap(transform: (T) -> Sequence<R>): List<R>

flatMapIndexed

Платформы и требования к версиям: Common (1.4)


@JvmName(name = "flatMapIndexedIterable")
inline fun <T, R> Array<out T>.flatMapIndexed(transform: (index: Int, T) -> Iterable<R>): List<R>


@JvmName(name = "flatMapIndexedSequence")
inline fun <T, R> Array<out T>.flatMapIndexed(transform: (index: Int, T) -> Sequence<R>): List<R>

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

flatMapIndexedTo

Платформы и требования к версиям: Common (1.4)



@JvmName(name = "flatMapIndexedIterableTo")


@IgnorableReturnValue

inline fun <T, R, C : MutableCollection<in R>> Array<out T>.flatMapIndexedTo(destination: C, transform: (index: Int, T) -> Iterable<R>): C



@JvmName(name = "flatMapIndexedSequenceTo")


@IgnorableReturnValue

inline fun <T, R, C : MutableCollection<in R>> Array<out T>.flatMapIndexedTo(destination: C, transform: (index: Int, T) -> Sequence<R>): C

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

flatMapTo

Платформы и требования к версиям: Common (1.0)


@IgnorableReturnValue
inline fun <T, R, C : MutableCollection<in R>> Array<out T>.flatMapTo(destination: C, transform: (T) -> Iterable<R>): C

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



@JvmName(name = "flatMapSequenceTo")


@IgnorableReturnValue

inline fun <T, R, C : MutableCollection<in R>> Array<out T>.flatMapTo(destination: C, transform: (T) -> Sequence<R>): C

flatten

Платформы и требования к версиям: Common (1.0)

fun <T> Array<out Array<out T>>.flatten(): List<T>

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

fold

Платформы и требования к версиям: Common (1.0)

inline fun <T, R> Array<out T>.fold(initial: R, operation: (acc: R, T) -> R): R

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

foldIndexed

Платформы и требования к версиям: Common (1.0)

inline fun <T, R> Array<out T>.foldIndexed(initial: R, operation: (index: Int, acc: R, T) -> R): R

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

foldRight

Платформы и требования к версиям: Common (1.0)

inline fun <T, R> Array<out T>.foldRight(initial: R, operation: (T, acc: R) -> R): R

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

foldRightIndexed

Платформы и требования к версиям: Common (1.0)

inline fun <T, R> Array<out T>.foldRightIndexed(initial: R, operation: (index: Int, T, acc: R) -> R): R

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

forEach

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.forEach(action: (T) -> Unit)

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

forEachIndexed

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.forEachIndexed(action: (index: Int, T) -> Unit)

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

get

Платформы и требования к версиям: Common (1.0), JS (1.1), JVM (1.0), Wasm-JS (1.8), Wasm-WASI (1.8)

expect operator fun get(index: Int): T

Возвращает элемент массива по заданному index.

Платформы и требования к версиям: Native (1.3)

actual operator external fun get(index: Int): T

Возвращает элемент массива по заданному index.

get

Платформы и требования к версиям: JS (2.2)


@ExperimentalWasmJsInterop
actual inline operator fun <T> JsArray<T>.get(index: Int): T?

getOrElse

Платформы и требования к версиям: Common (1.0)

inline fun <T> Array<out T>.getOrElse(index: Int, defaultValue: (Int) -> T): T

getOrNull

Платформы и требования к версиям: Common (1.0)

fun <T> Array<out T>.getOrNull(index: Int): T?

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

groupBy

Платформы и требования к версиям: Common (1.0)

inline fun <T, K> Array<out T>.groupBy(keySelector: (T) -> K): Map<K, List<T>>

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

inline fun <T, K, V> Array<out T>.groupBy(keySelector: (T) -> K, valueTransform: (T) -> V): Map<K, List<V>>

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

groupByTo

Платформы и требования к версиям: Common (1.0)


@IgnorableReturnValue
inline fun <T, K, M : MutableMap<in K, MutableList<T>>> Array<out T>.groupByTo(destination: M, keySelector: (T) -> K): M

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


@IgnorableReturnValue
inline fun <T, K, V, M : MutableMap<in K, MutableList<V>>> Array<out T>.groupByTo(destination: M, keySelector: (T) -> K, valueTransform: (T) -> V): M

Группирует значения, возвращаемые функцией valueTransform, применённой к каждому элементу исходного массива, по ключу, возвращаемому функцией keySelector, применённой к элементу, и помещает в карту destination каждый ключ группы, связанный со списком соответствующих значений.

groupingBy

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

inline fun <T, K> Array<out T>.groupingBy(crossinline keySelector: (T) -> K): Grouping<T, K>

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

indexOf

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

fun <T> Array<out T>.indexOf(element: T): Int

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

indexOfFirst

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

inline fun <T> Array<out T>.indexOfFirst(predicate: (T) -> Boolean): Int

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

indexOfLast

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

inline fun <T> Array<out T>.indexOfLast(predicate: (T) -> Boolean): Int

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

intersect

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

infix fun <T> Array<out T>.intersect(other: Iterable<T>): Set<T>

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

isArrayOf

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

fun <T : Any> Array<*>.isArrayOf(): Boolean

Проверяет, может ли массив содержать элемент типа T.

isEmpty

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

inline fun <T> Array<out T>.isEmpty(): Boolean

Возвращает true, если массив пуст.

isNotEmpty

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

inline fun <T> Array<out T>.isNotEmpty(): Boolean

Возвращает true, если массив не пуст.

isNullOrEmpty

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

inline fun Array<*>?.isNullOrEmpty(): Boolean

Возвращает true, если этот nullable-массив равен null или пуст.

isSorted

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

fun <T : Comparable<T>> Array<out T>.isSorted(): Boolean

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

isSortedBy

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

inline fun <T, R : Comparable<R>> Array<out T>.isSortedBy(selector: (T) -> R?): Boolean

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

isSortedByDescending

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

inline fun <T, R : Comparable<R>> Array<out T>.isSortedByDescending(selector: (T) -> R?): Boolean

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

isSortedDescending

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

fun <T : Comparable<T>> Array<out T>.isSortedDescending(): Boolean

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

isSortedWith

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

fun <T> Array<out T>.isSortedWith(comparator: Comparator<in T>): Boolean

Возвращает true, если каждый элемент массива меньше или равен следующему элементу согласно указанному comparator.

iterator

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect operator fun iterator(): Iterator<T>

Создает Iterator для перебора элементов массива.

joinTo

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


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

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

joinToString

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

fun <T> Array<out T>.joinToString(separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (T) -> CharSequence? = null): String

Создает строку из всех элементов, разделенных с помощью separator, а также использует заданные prefix и postfix, если они указаны.

last

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

fun <T> Array<out T>.last(): T

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

inline fun <T> Array<out T>.last(predicate: (T) -> Boolean): T

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

lastIndexOf

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

fun <T> Array<out T>.lastIndexOf(element: T): Int

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

lastOrNull

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

fun <T> Array<out T>.lastOrNull(): T?

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

inline fun <T> Array<out T>.lastOrNull(predicate: (T) -> Boolean): T?

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

map

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

inline fun <T, R> Array<out T>.map(transform: (T) -> R): List<R>

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

mapIndexed

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

inline fun <T, R> Array<out T>.mapIndexed(transform: (index: Int, T) -> R): List<R>

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

mapIndexedNotNull

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

inline fun <T, R : Any> Array<out T>.mapIndexedNotNull(transform: (index: Int, T) -> R?): List<R>

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

mapIndexedNotNullTo

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


@IgnorableReturnValue
inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapIndexedNotNullTo(destination: C, transform: (index: Int, T) -> R?): C

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

mapIndexedTo

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


@IgnorableReturnValue
inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapIndexedTo(destination: C, transform: (index: Int, T) -> R): C

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

mapNotNull

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

inline fun <T, R : Any> Array<out T>.mapNotNull(transform: (T) -> R?): List<R>

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

mapNotNullTo

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


@IgnorableReturnValue
inline fun <T, R : Any, C : MutableCollection<in R>> Array<out T>.mapNotNullTo(destination: C, transform: (T) -> R?): C

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

mapTo

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


@IgnorableReturnValue
inline fun <T, R, C : MutableCollection<in R>> Array<out T>.mapTo(destination: C, transform: (T) -> R): C

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

max

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


@JvmName(name = "maxOrThrow")
fun <T : Comparable<T>> Array<out T>.max(): T


@JvmName(name = "maxOrThrow")
fun Array<out Double>.max(): Double


@JvmName(name = "maxOrThrow")
fun Array<out Float>.max(): Float

Возвращает наибольший элемент.

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

fun <T : Comparable<T>> Array<out T>.max(): T?

maxBy

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


@JvmName(name = "maxByOrThrow")
inline fun <T, R : Comparable<R>> Array<out T>.maxBy(selector: (T) -> R): T

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

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

inline fun <T, R : Comparable<R>> Array<out T>.maxBy(selector: (T) -> R): T?

maxByOrNull

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

inline fun <T, R : Comparable<R>> Array<out T>.maxByOrNull(selector: (T) -> R): T?

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

maxOf

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

inline fun <T, R : Comparable<R>> Array<out T>.maxOf(selector: (T) -> R): R

inline fun <T> Array<out T>.maxOf(selector: (T) -> Double): Double

inline fun <T> Array<out T>.maxOf(selector: (T) -> Float): Float

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

maxOfOrNull

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

inline fun <T, R : Comparable<R>> Array<out T>.maxOfOrNull(selector: (T) -> R): R?

inline fun <T> Array<out T>.maxOfOrNull(selector: (T) -> Double): Double?

inline fun <T> Array<out T>.maxOfOrNull(selector: (T) -> Float): Float?

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

maxOfWith

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

inline fun <T, R> Array<out T>.maxOfWith(comparator: Comparator<in R>, selector: (T) -> R): R

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

maxOfWithOrNull

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

inline fun <T, R> Array<out T>.maxOfWithOrNull(comparator: Comparator<in R>, selector: (T) -> R): R?

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

maxOrNull

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

fun <T : Comparable<T>> Array<out T>.maxOrNull(): T?

fun Array<out Double>.maxOrNull(): Double?

fun Array<out Float>.maxOrNull(): Float?

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

maxWith

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


@JvmName(name = "maxWithOrThrow")
fun <T> Array<out T>.maxWith(comparator: Comparator<in T>): T

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

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

fun <T> Array<out T>.maxWith(comparator: Comparator<in T>): T?

maxWithOrNull

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

fun <T> Array<out T>.maxWithOrNull(comparator: Comparator<in T>): T?

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

min

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


@JvmName(name = "minOrThrow")
fun <T : Comparable<T>> Array<out T>.min(): T


@JvmName(name = "minOrThrow")
fun Array<out Double>.min(): Double


@JvmName(name = "minOrThrow")
fun Array<out Float>.min(): Float

Возвращает наименьший элемент.

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

fun <T : Comparable<T>> Array<out T>.min(): T?

minBy

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


@JvmName(name = "minByOrThrow")
inline fun <T, R : Comparable<R>> Array<out T>.minBy(selector: (T) -> R): T

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

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

inline fun <T, R : Comparable<R>> Array<out T>.minBy(selector: (T) -> R): T?

minByOrNull

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

inline fun <T, R : Comparable<R>> Array<out T>.minByOrNull(selector: (T) -> R): T?

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

minOf

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

inline fun <T, R : Comparable<R>> Array<out T>.minOf(selector: (T) -> R): R

inline fun <T> Array<out T>.minOf(selector: (T) -> Double): Double

inline fun <T> Array<out T>.minOf(selector: (T) -> Float): Float

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

minOfOrNull

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

inline fun <T, R : Comparable<R>> Array<out T>.minOfOrNull(selector: (T) -> R): R?

inline fun <T> Array<out T>.minOfOrNull(selector: (T) -> Double): Double?

inline fun <T> Array<out T>.minOfOrNull(selector: (T) -> Float): Float?

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

minOfWith

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

inline fun <T, R> Array<out T>.minOfWith(comparator: Comparator<in R>, selector: (T) -> R): R

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

minOfWithOrNull

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

inline fun <T, R> Array<out T>.minOfWithOrNull(comparator: Comparator<in R>, selector: (T) -> R): R?

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

minOrNull

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

fun <T : Comparable<T>> Array<out T>.minOrNull(): T?

fun Array<out Double>.minOrNull(): Double?

fun Array<out Float>.minOrNull(): Float?

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

minWith

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


@JvmName(name = "minWithOrThrow")
fun <T> Array<out T>.minWith(comparator: Comparator<in T>): T

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

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

fun <T> Array<out T>.minWith(comparator: Comparator<in T>): T?

minWithOrNull

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

fun <T> Array<out T>.minWithOrNull(comparator: Comparator<in T>): T?

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

none

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

fun <T> Array<out T>.none(): Boolean

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

inline fun <T> Array<out T>.none(predicate: (T) -> Boolean): Boolean

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

onEach

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

inline fun <T> Array<out T>.onEach(action: (T) -> Unit): Array<out T>

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

onEachIndexed

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

inline fun <T> Array<out T>.onEachIndexed(action: (index: Int, T) -> Unit): Array<out T>

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

orEmpty

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect inline fun <T> Array<out T>?.orEmpty(): Array<out T>

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

partition

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

inline fun <T> Array<out T>.partition(predicate: (T) -> Boolean): Pair<List<T>, List<T>>

Разбивает исходный массив на пару списков: первый список содержит элементы, для которых предикат вернул true, а второй список содержит элементы, для которых предикат вернул false.

plus

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

expect operator fun <T> Array<T>.plus(element: T): Array<T>

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

expect operator fun <T> Array<T>.plus(elements: Array<out T>): Array<T>

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

expect operator fun <T> Array<T>.plus(elements: Collection<T>): Array<T>

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

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

inline operator fun <T> Array<out T>.plus(element: T): Array<T>

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

inline operator fun <T> Array<out T>.plus(elements: Array<out T>): Array<T>

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

operator fun <T> Array<out T>.plus(elements: Collection<T>): Array<T>

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

plusElement

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

expect fun <T> Array<T>.plusElement(element: T): Array<T>

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

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

inline fun <T> Array<out T>.plusElement(element: T): Array<T>

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

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

actual inline fun <T> Array<T>.plusElement(element: T): Array<T>

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

random

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

inline fun <T> Array<out T>.random(): T

Возвращает случайный элемент этого массива.

fun <T> Array<out T>.random(random: Random): T

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

randomOrNull

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

inline fun <T> Array<out T>.randomOrNull(): T?

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

fun <T> Array<out T>.randomOrNull(random: Random): T?

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

reduce

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

inline fun <S, T : S> Array<out T>.reduce(operation: (acc: S, T) -> S): S

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

reduceIndexed

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

inline fun <S, T : S> Array<out T>.reduceIndexed(operation: (index: Int, acc: S, T) -> S): S

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

reduceIndexedOrNull

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

inline fun <S, T : S> Array<out T>.reduceIndexedOrNull(operation: (index: Int, acc: S, T) -> S): S?

reduceOrNull

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

inline fun <S, T : S> Array<out T>.reduceOrNull(operation: (acc: S, T) -> S): S?

reduceRight

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

inline fun <S, T : S> Array<out T>.reduceRight(operation: (T, acc: S) -> S): S

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

reduceRightIndexed

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

inline fun <S, T : S> Array<out T>.reduceRightIndexed(operation: (index: Int, T, acc: S) -> S): S

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

reduceRightIndexedOrNull

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

inline fun <S, T : S> Array<out T>.reduceRightIndexedOrNull(operation: (index: Int, T, acc: S) -> S): S?

reduceRightOrNull

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

inline fun <S, T : S> Array<out T>.reduceRightOrNull(operation: (T, acc: S) -> S): S?

requireNoNulls

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

fun <T : Any> Array<T?>.requireNoNulls(): Array<T>

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

reverse

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

fun <T> Array<T>.reverse()

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

fun <T> Array<T>.reverse(fromIndex: Int, toIndex: Int)

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

reversed

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

fun <T> Array<out T>.reversed(): List<T>

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

reversedArray

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

fun <T> Array<T>.reversedArray(): Array<T>

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

runningFold

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

inline fun <T, R> Array<out T>.runningFold(initial: R, operation: (acc: R, T) -> R): List<R>

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

runningFoldIndexed

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

inline fun <T, R> Array<out T>.runningFoldIndexed(initial: R, operation: (index: Int, acc: R, T) -> R): List<R>

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

runningReduce

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

inline fun <S, T : S> Array<out T>.runningReduce(operation: (acc: S, T) -> S): List<S>

runningReduceIndexed

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

inline fun <S, T : S> Array<out T>.runningReduceIndexed(operation: (index: Int, acc: S, T) -> S): List<S>

scan

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

inline fun <T, R> Array<out T>.scan(initial: R, operation: (acc: R, T) -> R): List<R>

scanIndexed

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

inline fun <T, R> Array<out T>.scanIndexed(initial: R, operation: (index: Int, acc: R, T) -> R): List<R>

set

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Wasm-JS (1.8), Wasm-WASI (1.8)

expect operator fun set(index: Int, value: T)

Задаёт элементу массива по указанному индексу заданное значение.

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

actual operator external fun set(index: Int, value: T)

Задаёт элементу массива по указанному индексу заданное значение.

set

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


@ExperimentalWasmJsInterop
actual inline operator fun <T> JsArray<T>.set(index: Int, value: T)

shuffle

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

fun <T> Array<T>.shuffle()

Перемешивает элементы этого массива в случайном порядке на месте.

fun <T> Array<T>.shuffle(random: Random)

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

single

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

fun <T> Array<out T>.single(): T

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

inline fun <T> Array<out T>.single(predicate: (T) -> Boolean): T

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

singleOrNull

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

fun <T> Array<out T>.singleOrNull(): T?

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

inline fun <T> Array<out T>.singleOrNull(predicate: (T) -> Boolean): T?

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

slice

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

fun <T> Array<out T>.slice(indices: Iterable<Int>): List<T>

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

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

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

sliceArray

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

fun <T> Array<T>.sliceArray(indices: Collection<Int>): Array<T>

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

fun <T> Array<T>.sliceArray(indices: IntRange): Array<T>

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

sort

Требования к платформе и версии: Common (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T : Comparable<T>> Array<out T>.sort()

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

expect fun <T : Comparable<T>> Array<out T>.sort(fromIndex: Int = 0, toIndex: Int = size)

Сортирует диапазон массива на месте.

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

actual fun <T : Comparable<T>> Array<out T>.sort()

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

fun <T> Array<out T>.sort(comparison: (a: T, b: T) -> Int)

Сортирует массив на месте в порядке, заданном функцией сравнения.

actual fun <T : Comparable<T>> Array<out T>.sort(fromIndex: Int = 0, toIndex: Int = size)

Сортирует диапазон массива на месте.

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

fun <T> Array<out T>.sort()

actual inline fun <T : Comparable<T>> Array<out T>.sort()

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

fun <T> Array<out T>.sort(fromIndex: Int = 0, toIndex: Int = size)

Сортирует диапазон массива на месте.

actual fun <T : Comparable<T>> Array<out T>.sort(fromIndex: Int = 0, toIndex: Int = size)

Сортирует диапазон массива на месте.

sortBy

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

inline fun <T, R : Comparable<R>> Array<out T>.sortBy(crossinline selector: (T) -> R?)

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

sortByDescending

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

inline fun <T, R : Comparable<R>> Array<out T>.sortByDescending(crossinline selector: (T) -> R?)

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

sortDescending

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

fun <T : Comparable<T>> Array<out T>.sortDescending()

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

fun <T : Comparable<T>> Array<out T>.sortDescending(fromIndex: Int, toIndex: Int)

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

sorted

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

fun <T : Comparable<T>> Array<out T>.sorted(): List<T>

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

sortedArray

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

fun <T : Comparable<T>> Array<T>.sortedArray(): Array<T>

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

sortedArrayDescending

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

fun <T : Comparable<T>> Array<T>.sortedArrayDescending(): Array<T>

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

sortedArrayWith

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

fun <T> Array<out T>.sortedArrayWith(comparator: Comparator<in T>): Array<out T>

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

sortedBy

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

inline fun <T, R : Comparable<R>> Array<out T>.sortedBy(crossinline selector: (T) -> R?): List<T>

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

sortedByDescending

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

inline fun <T, R : Comparable<R>> Array<out T>.sortedByDescending(crossinline selector: (T) -> R?): List<T>

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

sortedDescending

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

fun <T : Comparable<T>> Array<out T>.sortedDescending(): List<T>

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

sortedWith

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

fun <T> Array<out T>.sortedWith(comparator: Comparator<in T>): List<T>

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

sortWith

Требования к платформе и версии: Common (1.0), JS (1.1), JVM (1.0), Native (1.3), Wasm-JS (1.8), Wasm-WASI (1.8)

expect fun <T> Array<out T>.sortWith(comparator: Comparator<in T>)

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

expect fun <T> Array<out T>.sortWith(comparator: Comparator<in T>, fromIndex: Int = 0, toIndex: Int = size)

Сортирует диапазон массива на месте с помощью указанного comparator.

subtract

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

infix fun <T> Array<out T>.subtract(other: Iterable<T>): Set<T>

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

sum

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


@JvmName(name = "sumOfByte")
fun Array<out Byte>.sum(): Int


@JvmName(name = "sumOfDouble")
fun Array<out Double>.sum(): Double


@JvmName(name = "sumOfFloat")
fun Array<out Float>.sum(): Float


@JvmName(name = "sumOfInt")
fun Array<out Int>.sum(): Int


@JvmName(name = "sumOfLong")
fun Array<out Long>.sum(): Long


@JvmName(name = "sumOfShort")
fun Array<out Short>.sum(): Int

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


@JvmName(name = "sumOfUByte")
fun Array<out UByte>.sum(): UInt


@JvmName(name = "sumOfUInt")
fun Array<out UInt>.sum(): UInt


@JvmName(name = "sumOfULong")
fun Array<out ULong>.sum(): ULong


@JvmName(name = "sumOfUShort")
fun Array<out UShort>.sum(): UInt

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

sumBy

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

inline fun <T> Array<out T>.sumBy(selector: (T) -> Int): Int

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

sumByDouble

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

inline fun <T> Array<out T>.sumByDouble(selector: (T) -> Double): Double

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

sumOf

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


@JvmName(name = "sumOfDouble")
inline fun <T> Array<out T>.sumOf(selector: (T) -> Double): Double


@JvmName(name = "sumOfInt")
inline fun <T> Array<out T>.sumOf(selector: (T) -> Int): Int


@JvmName(name = "sumOfLong")
inline fun <T> Array<out T>.sumOf(selector: (T) -> Long): Long

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


@JvmName(name = "sumOfUInt")
inline fun <T> Array<out T>.sumOf(selector: (T) -> UInt): UInt


@JvmName(name = "sumOfULong")
inline fun <T> Array<out T>.sumOf(selector: (T) -> ULong): ULong

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

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


@JvmName(name = "sumOfBigDecimal")
inline fun <T> Array<out T>.sumOf(selector: (T) -> BigDecimal): BigDecimal


@JvmName(name = "sumOfBigInteger")
inline fun <T> Array<out T>.sumOf(selector: (T) -> BigInteger): BigInteger

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

take

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

fun <T> Array<out T>.take(n: Int): List<T>

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

takeLast

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

fun <T> Array<out T>.takeLast(n: Int): List<T>

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

takeLastWhile

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

inline fun <T> Array<out T>.takeLastWhile(predicate: (T) -> Boolean): List<T>

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

takeWhile

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

inline fun <T> Array<out T>.takeWhile(predicate: (T) -> Boolean): List<T>

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

toArray

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


@ExperimentalWasmJsInterop
actual inline fun <T> JsArray<T>.toArray(): Array<T>

toBooleanArray

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

fun Array<out Boolean>.toBooleanArray(): BooleanArray

Возвращает массив Boolean, содержащий все элементы этого обобщённого массива.

toByteArray

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

fun Array<out Byte>.toByteArray(): ByteArray

Возвращает массив Byte, содержащий все элементы этого обобщённого массива.

toCharArray

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

fun Array<out Char>.toCharArray(): CharArray

Возвращает массив Char, содержащий все элементы этого обобщённого массива.

toCollection

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


@IgnorableReturnValue
fun <T, C : MutableCollection<in T>> Array<out T>.toCollection(destination: C): C

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

toCStringArray

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

fun Array<String>.toCStringArray(autofreeScope: AutofreeScope): CPointer<CPointerVar<ByteVar>>

Преобразует этот массив строк Kotlin в массив строк C, выделяя память для массива и строк C в указанной области AutofreeScope.

toCValues

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

fun <T : CPointed> Array<CPointer<T>?>.toCValues(): CValues<CPointerVar<T>>

toDoubleArray

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

fun Array<out Double>.toDoubleArray(): DoubleArray

Возвращает массив Double, содержащий все элементы этого обобщённого массива.

toFloatArray

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

fun Array<out Float>.toFloatArray(): FloatArray

Возвращает массив Float, содержащий все элементы этого обобщённого массива.

toHashSet

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

fun <T> Array<out T>.toHashSet(): HashSet<T>

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

toIntArray

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

fun Array<out Int>.toIntArray(): IntArray

Возвращает массив Int, содержащий все элементы этого обобщённого массива.

toJsArray

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


@ExperimentalWasmJsInterop
actual inline fun <T> Array<T>.toJsArray(): JsArray<T>

Требования к платформе и версии: Wasm-JS (1.8)


@ExperimentalWasmJsInterop
actual fun <T : JsAny?> Array<T>.toJsArray(): JsArray<T>

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

toList

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

fun <T> Array<out T>.toList(): List<T>

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

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


@ExperimentalWasmJsInterop
actual inline fun <T> JsArray<T>.toList(): List<T>

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

toLongArray

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

fun Array<out Long>.toLongArray(): LongArray

Возвращает массив Long, содержащий все элементы этого обобщённого массива.

toMap

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

fun <K, V> Array<out Pair<K, V>>.toMap(): Map<K, V>

Возвращает новую карту, содержащую все пары «ключ-значение» из заданного массива пар.


@IgnorableReturnValue
fun <K, V, M : MutableMap<in K, in V>> Array<out Pair<K, V>>.toMap(destination: M): M

Заполняет карту назначения destination и возвращает её; карта заполняется парами «ключ-значение» из заданного массива пар.

toMutableList

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

fun <T> Array<out T>.toMutableList(): MutableList<T>

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

toMutableSet

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

fun <T> Array<out T>.toMutableSet(): MutableSet<T>

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

toSet

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

fun <T> Array<out T>.toSet(): Set<T>

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

toShortArray

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

fun Array<out Short>.toShortArray(): ShortArray

Возвращает массив Short, содержащий все элементы этого обобщённого массива.

toSortedSet

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

fun <T : Comparable<T>> Array<out T>.toSortedSet(): SortedSet<T>

fun <T> Array<out T>.toSortedSet(comparator: Comparator<in T>): SortedSet<T>

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

toUByteArray

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


@ExperimentalUnsignedTypes
fun Array<out UByte>.toUByteArray(): UByteArray

Возвращает массив UByte, содержащий все элементы этого обобщённого массива.

toUIntArray

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


@ExperimentalUnsignedTypes
fun Array<out UInt>.toUIntArray(): UIntArray

Возвращает массив UInt, содержащий все элементы этого обобщённого массива.

toULongArray

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


@ExperimentalUnsignedTypes
fun Array<out ULong>.toULongArray(): ULongArray

Возвращает массив ULong, содержащий все элементы этого обобщённого массива.

toUShortArray

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


@ExperimentalUnsignedTypes
fun Array<out UShort>.toUShortArray(): UShortArray

Возвращает массив UShort, содержащий все элементы этого обобщённого массива.

union

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

infix fun <T> Array<out T>.union(other: Iterable<T>): Set<T>

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

unzip

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

fun <T, R> Array<out Pair<T, R>>.unzip(): Pair<List<T>, List<R>>

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

withIndex

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

fun <T> Array<out T>.withIndex(): Iterable<IndexedValue<T>>

Возвращает ленивый Iterable, который оборачивает каждый элемент исходного массива в IndexedValue, содержащий индекс этого элемента и сам элемент.

zip

Требования к платформе и версии: Общая (1.0)

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

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

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

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

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

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

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

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

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-array/