W3cubDocs

/Kotlin

reduce

Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0)
inline fun <S, T : S> Sequence<T>.reduce(
    operation: (acc: S, T) -> S
): S

Accumulates value starting with the first element and applying operation from left to right to current accumulator value and each element.

Throws an exception if this sequence is empty. If the sequence can be empty in an expected way, please use reduceOrNull instead. It returns null when its receiver is empty.

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
}

Parameters

operation -

function that takes current accumulator value and an element, and calculates the next accumulator value.

The operation is terminal.

© 2010–2020 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.sequences/reduce.html