LongRange

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

class LongRange(start: Long, endInclusive: Long) : LongProgression, ClosedRange<Long> , OpenEndRange<Long>

Диапазон значений типа Long.

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

LongRange

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

constructor(start: Long, endInclusive: Long)

Типы

Companion

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

object Companion

Свойства

endExclusive

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

open override val endExclusive: Long

Максимальное значение диапазона (не включительно).

endInclusive

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

open override val endInclusive: Long

Максимальное значение диапазона (включительно).

first

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

val first: Long

Первый элемент прогрессии.

last

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

val last: Long

Последний элемент прогрессии.

start

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

open override val start: Long

Минимальное значение диапазона.

step

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

val step: Long

Шаг прогрессии.

Функции

all

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

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

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

allDistinct

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


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

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

allDistinctBy

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


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

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

allEqual

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


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

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

allEqualBy

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


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

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

any

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

fun <T> Iterable<T>.any(): Boolean

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

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

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

asIterable

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

inline fun <T> Iterable<T>.asIterable(): Iterable<T>

Возвращает эту коллекцию как Iterable.

asSequence

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

fun <T> Iterable<T>.asSequence(): Sequence<T>

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

associate

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

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

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

associateBy

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

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

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

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

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

associateByTo

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


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

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


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

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

associateTo

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


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

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

associateWith

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

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

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

associateWithTo

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


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

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

average

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


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


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


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


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


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


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

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

chunked

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

fun <T> Iterable<T>.chunked(size: Int): List<List<T>>

Разбивает эту коллекцию на список списков, каждый из которых не превышает заданный размер.

fun <T, R> Iterable<T>.chunked(size: Int, transform: (List<T>) -> R): List<R>

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

contains

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

open operator override fun contains(value: Long): Boolean

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

contains

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

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

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


@JvmName(name = "byteRangeContains")
operator fun ClosedRange<Byte>.contains(value: Double): Boolean


@JvmName(name = "byteRangeContains")
operator fun ClosedRange<Byte>.contains(value: Float): Boolean


@JvmName(name = "byteRangeContains")
operator fun ClosedRange<Byte>.contains(value: Int): Boolean


@JvmName(name = "byteRangeContains")
operator fun ClosedRange<Byte>.contains(value: Long): Boolean


@JvmName(name = "byteRangeContains")
operator fun ClosedRange<Byte>.contains(value: Short): Boolean


@JvmName(name = "doubleRangeContains")
operator fun ClosedRange<Double>.contains(value: Byte): Boolean


@JvmName(name = "doubleRangeContains")
operator fun ClosedRange<Double>.contains(value: Float): Boolean


@JvmName(name = "doubleRangeContains")
operator fun ClosedRange<Double>.contains(value: Int): Boolean


@JvmName(name = "doubleRangeContains")
operator fun ClosedRange<Double>.contains(value: Long): Boolean


@JvmName(name = "doubleRangeContains")
operator fun ClosedRange<Double>.contains(value: Short): Boolean


@JvmName(name = "floatRangeContains")
operator fun ClosedRange<Float>.contains(value: Byte): Boolean


@JvmName(name = "floatRangeContains")
operator fun ClosedRange<Float>.contains(value: Double): Boolean


@JvmName(name = "floatRangeContains")
operator fun ClosedRange<Float>.contains(value: Int): Boolean


@JvmName(name = "floatRangeContains")
operator fun ClosedRange<Float>.contains(value: Long): Boolean


@JvmName(name = "floatRangeContains")
operator fun ClosedRange<Float>.contains(value: Short): Boolean


@JvmName(name = "intRangeContains")
operator fun ClosedRange<Int>.contains(value: Byte): Boolean


@JvmName(name = "intRangeContains")
operator fun ClosedRange<Int>.contains(value: Double): Boolean


@JvmName(name = "intRangeContains")
operator fun ClosedRange<Int>.contains(value: Float): Boolean


@JvmName(name = "intRangeContains")
operator fun ClosedRange<Int>.contains(value: Long): Boolean


@JvmName(name = "intRangeContains")
operator fun ClosedRange<Int>.contains(value: Short): Boolean


@JvmName(name = "longRangeContains")
operator fun ClosedRange<Long>.contains(value: Byte): Boolean


@JvmName(name = "longRangeContains")
operator fun ClosedRange<Long>.contains(value: Double): Boolean


@JvmName(name = "longRangeContains")
operator fun ClosedRange<Long>.contains(value: Float): Boolean


@JvmName(name = "longRangeContains")
operator fun ClosedRange<Long>.contains(value: Int): Boolean


@JvmName(name = "longRangeContains")
operator fun ClosedRange<Long>.contains(value: Short): Boolean


@JvmName(name = "shortRangeContains")
operator fun ClosedRange<Short>.contains(value: Byte): Boolean


@JvmName(name = "shortRangeContains")
operator fun ClosedRange<Short>.contains(value: Double): Boolean


@JvmName(name = "shortRangeContains")
operator fun ClosedRange<Short>.contains(value: Float): Boolean


@JvmName(name = "shortRangeContains")
operator fun ClosedRange<Short>.contains(value: Int): Boolean


@JvmName(name = "shortRangeContains")
operator fun ClosedRange<Short>.contains(value: Long): Boolean

inline operator fun LongRange.contains(value: Byte): Boolean

inline operator fun LongRange.contains(value: Int): Boolean

inline operator fun LongRange.contains(value: Short): Boolean

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

inline operator fun LongRange.contains(element: Long?): Boolean

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


@JvmName(name = "byteRangeContains")
operator fun OpenEndRange<Byte>.contains(value: Int): Boolean


@JvmName(name = "byteRangeContains")
operator fun OpenEndRange<Byte>.contains(value: Long): Boolean


@JvmName(name = "byteRangeContains")
operator fun OpenEndRange<Byte>.contains(value: Short): Boolean


@JvmName(name = "doubleRangeContains")
operator fun OpenEndRange<Double>.contains(value: Float): Boolean


@JvmName(name = "intRangeContains")
operator fun OpenEndRange<Int>.contains(value: Byte): Boolean


@JvmName(name = "intRangeContains")
operator fun OpenEndRange<Int>.contains(value: Long): Boolean


@JvmName(name = "intRangeContains")
operator fun OpenEndRange<Int>.contains(value: Short): Boolean


@JvmName(name = "longRangeContains")
operator fun OpenEndRange<Long>.contains(value: Byte): Boolean


@JvmName(name = "longRangeContains")
operator fun OpenEndRange<Long>.contains(value: Int): Boolean


@JvmName(name = "longRangeContains")
operator fun OpenEndRange<Long>.contains(value: Short): Boolean


@JvmName(name = "shortRangeContains")
operator fun OpenEndRange<Short>.contains(value: Byte): Boolean


@JvmName(name = "shortRangeContains")
operator fun OpenEndRange<Short>.contains(value: Int): Boolean


@JvmName(name = "shortRangeContains")
operator fun OpenEndRange<Short>.contains(value: Long): Boolean

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

count

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

fun <T> Iterable<T>.count(): Int

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

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

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

distinct

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

fun <T> Iterable<T>.distinct(): List<T>

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

distinctBy

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

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

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

drop

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

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

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

dropWhile

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

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

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

elementAt

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

fun <T> Iterable<T>.elementAt(index: Int): T

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

elementAtOrElse

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

fun <T> Iterable<T>.elementAtOrElse(index: Int, defaultValue: (Int) -> T): T

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

elementAtOrNull

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

fun <T> Iterable<T>.elementAtOrNull(index: Int): T?

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

equals

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

open operator override fun equals(other: Any?): Boolean

Указывает, равен ли этот объект какому-либо другому объекту.

filter

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

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

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

filterIndexed

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

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

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

filterIndexedTo

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


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

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

filterIsInstance

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

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

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

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

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

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

filterIsInstanceTo

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


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

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

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


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

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

filterNot

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

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

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

filterNotNull

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

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

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

filterNotNullTo

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


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

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

filterNotTo

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


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

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

filterTo

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


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

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

find

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

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

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

findLast

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

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

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

first

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

fun <T> Iterable<T>.first(): T

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

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

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

fun LongProgression.first(): Long

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

firstNotNullOf

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

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

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

firstNotNullOfOrNull

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

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

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

firstOrNull

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

fun <T> Iterable<T>.firstOrNull(): T?

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

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

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

fun LongProgression.firstOrNull(): Long?

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

flatMap

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

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

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


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

flatMapIndexed

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


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


@JvmName(name = "flatMapIndexedSequence")
inline fun <T, R> Iterable<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>> Iterable<T>.flatMapIndexedTo(destination: C, transform: (index: Int, T) -> Iterable<R>): C



@JvmName(name = "flatMapIndexedSequenceTo")


@IgnorableReturnValue

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

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

flatMapTo

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


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

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



@JvmName(name = "flatMapSequenceTo")


@IgnorableReturnValue

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

flatten

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

fun <T> Iterable<Iterable<T>>.flatten(): List<T>

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

fold

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

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

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

foldIndexed

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

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

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

forEach

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

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

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

forEachIndexed

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

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

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

groupBy

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

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

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

inline fun <T, K, V> Iterable<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>>> Iterable<T>.groupByTo(destination: M, keySelector: (T) -> K): M

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


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

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

groupingBy

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

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

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

hashCode

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

open override fun hashCode(): Int

Возвращает хеш-код объекта.

indexOf

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

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

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

indexOfFirst

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

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

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

indexOfLast

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

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

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

intersect

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

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

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

isEmpty

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

open override fun isEmpty(): Boolean

Проверяет, пуста ли область.

isSorted

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

fun <T : Comparable<T>> Iterable<T>.isSorted(): Boolean

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

isSortedBy

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

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

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

isSortedByDescending

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

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

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

isSortedDescending

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

fun <T : Comparable<T>> Iterable<T>.isSortedDescending(): Boolean

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

isSortedWith

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

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

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

iterator

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

open operator override fun iterator(): LongIterator

Возвращает итератор элементов этого объекта.

joinTo

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


@IgnorableReturnValue
fun <T, A : Appendable> Iterable<T>.joinTo(buffer: A, separator: CharSequence = ", ", prefix: CharSequence = "", postfix: CharSequence = "", limit: Int = -1, truncated: CharSequence = "...", transform: (T) -> CharSequence? = null): A

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

joinToString

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

fun <T> Iterable<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> Iterable<T>.last(): T

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

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

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

fun LongProgression.last(): Long

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

lastIndexOf

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

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

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

lastOrNull

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

fun <T> Iterable<T>.lastOrNull(): T?

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

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

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

fun LongProgression.lastOrNull(): Long?

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

map

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

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

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

mapIndexed

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

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

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

mapIndexedNotNull

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

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

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

mapIndexedNotNullTo

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


@IgnorableReturnValue
inline fun <T, R : Any, C : MutableCollection<in R>> Iterable<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>> Iterable<T>.mapIndexedTo(destination: C, transform: (index: Int, T) -> R): C

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

mapNotNull

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

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

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

mapNotNullTo

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


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

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

mapTo

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


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

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

max

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


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


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


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

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

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

fun <T : Comparable<T>> Iterable<T>.max(): T?

fun Iterable<Double>.max(): Double?

fun Iterable<Float>.max(): Float?

maxBy

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


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

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

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

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

maxByOrNull

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

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

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

maxOf

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

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

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

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

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

maxOfOrNull

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

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

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

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

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

maxOfWith

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

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

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

maxOfWithOrNull

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

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

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

maxOrNull

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

fun <T : Comparable<T>> Iterable<T>.maxOrNull(): T?

fun Iterable<Double>.maxOrNull(): Double?

fun Iterable<Float>.maxOrNull(): Float?

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

maxWith

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


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

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

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

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

maxWithOrNull

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

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

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

min

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


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


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


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

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

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

fun <T : Comparable<T>> Iterable<T>.min(): T?

fun Iterable<Double>.min(): Double?

fun Iterable<Float>.min(): Float?

minBy

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


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

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

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

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

minByOrNull

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

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

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

minOf

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

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

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

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

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

minOfOrNull

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

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

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

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

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

minOfWith

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

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

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

minOfWithOrNull

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

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

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

minOrNull

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

fun <T : Comparable<T>> Iterable<T>.minOrNull(): T?

fun Iterable<Double>.minOrNull(): Double?

fun Iterable<Float>.minOrNull(): Float?

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

minus

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

operator fun <T> Iterable<T>.minus(element: T): List<T>

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

operator fun <T> Iterable<T>.minus(elements: Array<out T>): List<T>

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

operator fun <T> Iterable<T>.minus(elements: Iterable<T>): List<T>

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

operator fun <T> Iterable<T>.minus(elements: Sequence<T>): List<T>

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

minusElement

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

inline fun <T> Iterable<T>.minusElement(element: T): List<T>

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

minWith

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


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

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

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

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

minWithOrNull

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

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

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

none

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

fun <T> Iterable<T>.none(): Boolean

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

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

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

partition

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

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

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

plus

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

operator fun <T> Iterable<T>.plus(element: T): List<T>

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

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

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

operator fun <T> Iterable<T>.plus(elements: Iterable<T>): List<T>

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

operator fun <T> Iterable<T>.plus(elements: Sequence<T>): List<T>

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

plusElement

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

inline fun <T> Iterable<T>.plusElement(element: T): List<T>

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

random

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

inline fun LongRange.random(): Long

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

fun LongRange.random(random: Random): Long

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

randomOrNull

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

inline fun LongRange.randomOrNull(): Long?

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

fun LongRange.randomOrNull(random: Random): Long?

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

reduce

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

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

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

reduceIndexed

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

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

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

reduceIndexedOrNull

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

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

reduceOrNull

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

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

requireNoNulls

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

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

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

reversed

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

fun <T> Iterable<T>.reversed(): List<T>

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

fun LongProgression.reversed(): LongProgression

Возвращает прогрессию, проходящую по тому же диапазону в обратном направлении с тем же шагом.

runningFold

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

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

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

runningFoldIndexed

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

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

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

runningReduce

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

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

runningReduceIndexed

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

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

scan

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

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

scanIndexed

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

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

shuffled

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

expect fun <T> Iterable<T>.shuffled(): List<T>

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

fun <T> Iterable<T>.shuffled(random: Random): List<T>

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

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

actual fun <T> Iterable<T>.shuffled(): List<T>

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

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

actual fun <T> Iterable<T>.shuffled(): List<T>

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

fun <T> Iterable<T>.shuffled(random: Random): List<T>

single

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

fun <T> Iterable<T>.single(): T

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

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

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

singleOrNull

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

fun <T> Iterable<T>.singleOrNull(): T?

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

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

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

sorted

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

fun <T : Comparable<T>> Iterable<T>.sorted(): List<T>

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

sortedBy

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

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

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

sortedByDescending

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

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

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

sortedDescending

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

fun <T : Comparable<T>> Iterable<T>.sortedDescending(): List<T>

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

sortedWith

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

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

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

step

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

infix fun LongProgression.step(step: Long): LongProgression

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

subtract

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

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

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

sum

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


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


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


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


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


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


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

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


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


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


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


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

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

sumBy

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

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

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

sumByDouble

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

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

sumOf

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


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


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


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


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


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

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


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


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

take

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

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

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

takeWhile

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

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

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

toCollection

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


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

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

toHashSet

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

fun <T> Iterable<T>.toHashSet(): HashSet<T>

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

toList

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

fun <T> Iterable<T>.toList(): List<T>

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

toMap

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

fun <K, V> Iterable<Pair<K, V>>.toMap(): Map<K, V>

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


@IgnorableReturnValue
fun <K, V, M : MutableMap<in K, in V>> Iterable<Pair<K, V>>.toMap(destination: M): M

Заполняет изменяемую карту назначения парами ключ-значение из заданной коллекции пар и возвращает её.

toMutableList

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

fun <T> Iterable<T>.toMutableList(): MutableList<T>

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

toMutableSet

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

fun <T> Iterable<T>.toMutableSet(): MutableSet<T>

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

toSet

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

fun <T> Iterable<T>.toSet(): Set<T>

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

toSortedSet

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

fun <T : Comparable<T>> Iterable<T>.toSortedSet(): SortedSet<T>

fun <T> Iterable<T>.toSortedSet(comparator: Comparator<in T>): SortedSet<T>

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

toString

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

open override fun toString(): String

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

union

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

infix fun <T> Iterable<T>.union(other: Iterable<T>): Set<T>

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

unzip

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

fun <T, R> Iterable<Pair<T, R>>.unzip(): Pair<List<T>, List<R>>

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

windowed

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

fun <T> Iterable<T>.windowed(size: Int, step: Int = 1, partialWindows: Boolean = false): List<List<T>>

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

fun <T, R> Iterable<T>.windowed(size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (List<T>) -> R): List<R>

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

withIndex

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

fun <T> Iterable<T>.withIndex(): Iterable<IndexedValue<T>>

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

zip

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

infix fun <T, R> Iterable<T>.zip(other: Array<out R>): List<Pair<T, R>>

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

infix fun <T, R> Iterable<T>.zip(other: Iterable<R>): List<Pair<T, R>>

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

inline fun <T, R, V> Iterable<T>.zip(other: Array<out R>, transform: (a: T, b: R) -> V): List<V>

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

inline fun <T, R, V> Iterable<T>.zip(other: Iterable<R>, transform: (a: T, b: R) -> V): List<V>

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

zipWithNext

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

fun <T> Iterable<T>.zipWithNext(): List<Pair<T, T>>

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

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

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

© 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.ranges/-long-range/index.html