Spec-Zone.ru › Kotlin 2

reduce

kotlin-stdlib/kotlin.collections/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.

Параметры

operation

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

Примеры

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.

Параметры

operation

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

Примеры

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
}

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

Параметры

operation

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

Примеры

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, связывающая ключ каждой группы с результатом накопления элементов этой группы.

Параметры

operation

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

  • 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

Spec-Zone.ru

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