Spec-Zone.ru › Kotlin 1.8

reduce

kotlin-stdlib / kotlin.collections / reduce
Требования к платформе и версии: JVM (1.0), JS (1.0), Native (1.0)
inline fun <S, T : S> Array<out T>.reduce(
    operation: (acc: S, T) -> S
): S
inline fun ByteArray.reduce(
    operation: (acc: Byte, Byte) -> Byte
): Byte
inline fun ShortArray.reduce(
    operation: (acc: Short, Short) -> Short
): Short
inline fun IntArray.reduce(
    operation: (acc: Int, Int) -> Int
): Int
inline fun LongArray.reduce(
    operation: (acc: Long, Long) -> Long
): Long
inline fun FloatArray.reduce(
    operation: (acc: Float, Float) -> Float
): Float
inline fun DoubleArray.reduce(
    operation: (acc: Double, Double) -> Double
): Double
inline fun BooleanArray.reduce(
    operation: (acc: Boolean, Boolean) -> Boolean
): Boolean
inline fun CharArray.reduce(
    operation: (acc: Char, Char) -> Char
): Char
@ExperimentalUnsignedTypes inline fun UIntArray.reduce(
    operation: (acc: UInt, UInt) -> UInt
): UInt
@ExperimentalUnsignedTypes inline fun ULongArray.reduce(
    operation: (acc: ULong, ULong) -> ULong
): ULong
@ExperimentalUnsignedTypes inline fun UByteArray.reduce(
    operation: (acc: UByte, UByte) -> UByte
): UByte
@ExperimentalUnsignedTypes inline fun UShortArray.reduce(
    operation: (acc: UShort, UShort) -> UShort
): UShort

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

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

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val strings = listOf("a", "b", "c", "d")
println(strings.reduce { acc, string -> acc + string }) // abcd
println(strings.reduceIndexed { index, acc, string -> acc + string + index }) // ab1c2d3

// emptyList<Int>().reduce { _, _ -> 0 } //  will fail
//sampleEnd
}

Параметры

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

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

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

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

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val strings = listOf("a", "b", "c", "d")
println(strings.reduce { acc, string -> acc + string }) // abcd
println(strings.reduceIndexed { index, acc, string -> acc + string + index }) // ab1c2d3

// emptyList<Int>().reduce { _, _ -> 0 } //  will fail
//sampleEnd
}

Параметры

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

Требования к платформе и версии: JVM (1.1), JS (1.1), Native (1.1)
inline fun <S, T : S, K> Grouping<T, K>.reduce(
    operation: (key: K, accumulator: S, element: T) -> S
): Map<K, S>

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



fun main(args: Array<String>) {
//sampleStart
val animals = listOf("raccoon", "reindeer", "cow", "camel", "giraffe", "goat")

// grouping by first char and collect only max of contains vowels
val compareByVowelCount = compareBy { s: String -> s.count { it in "aeiou" } }

val maxVowels = animals.groupingBy { it.first() }.reduce { _, a, b -> maxOf(a, b, compareByVowelCount) }

println(maxVowels) // {r=reindeer, c=camel, g=giraffe}
//sampleEnd
}

Параметры

operation - функция, которая вызывается для каждого последующего элемента группы со следующими параметрами:

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

© 2010–2022 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/latest/jvm/stdlib/kotlin.collections/reduce.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API