reduce
Версия Kotlin: 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
Накапливает значение, начиная с первого элемента и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу.
Выбрасывает исключение, если этот массив пуст. Если массив может быть пустым в предусмотренном случае, используйте вместо этого reduceOrNull. Если получатель пуст, функция возвращает null.
Параметры
функция, принимающая текущее значение аккумулятора и элемент и вычисляющая следующее значение аккумулятора.
Примеры
import kotlin.math.*
import kotlin.test.*
fun main() {
//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
}
inline fun <S, T : S> Iterable<T>.reduce(operation: (acc: S, T) -> S): S
Накапливает значение, начиная с первого элемента и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу.
Выбрасывает исключение, если эта коллекция пуста. Если коллекция может быть пустой в предусмотренном случае, используйте вместо этого reduceOrNull. Если получатель пуст, функция возвращает null.
Параметры
функция, принимающая текущее значение аккумулятора и элемент и вычисляющая следующее значение аккумулятора.
Примеры
import kotlin.math.*
import kotlin.test.*
fun main() {
//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
}
inline fun UIntArray.reduce(operation: (acc: UInt, UInt) -> UInt): UInt
inline fun ULongArray.reduce(operation: (acc: ULong, ULong) -> ULong): ULong
inline fun UByteArray.reduce(operation: (acc: UByte, UByte) -> UByte): UByte
inline fun UShortArray.reduce(operation: (acc: UShort, UShort) -> UShort): UShort
Накапливает значение, начиная с первого элемента и применяя операцию слева направо к текущему значению аккумулятора и каждому элементу.
Выбрасывает исключение, если этот массив пуст. Если массив может быть пустым в предусмотренном случае, используйте вместо этого reduceOrNull. Если получатель пуст, функция возвращает null.
Параметры
функция, принимающая текущее значение аккумулятора и элемент и вычисляющая следующее значение аккумулятора.
Примеры
import kotlin.math.*
import kotlin.test.*
fun main() {
//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
}
inline fun <S, T : S, K> Grouping<T, K>.reduce(operation: (key: K, accumulator: S, element: T) -> S): Map<K, S>
Группирует элементы исходного Grouping по ключу и последовательно применяет редуцирующую операцию к элементам каждой группы, начиная со второго элемента группы. В качестве аргументов передаются ранее накопленное значение и текущий элемент, а результаты сохраняются в новой map. Начальным значением аккумулятора является первый элемент группы.
Возвращаемое значение
Map, связывающая ключ каждой группы с результатом накопления элементов этой группы.
Параметры
функция, вызываемая для каждого следующего элемента группы со следующими параметрами:
key: ключ группы, к которой принадлежит этот элемент;accumulator: текущее значение аккумулятора группы;element: элемент исходной последовательности, который накапливается.
Примеры
fun main() {
//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
}
© 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.collections/reduce.html