Spec-Zone.ru › Kotlin 1.6

reduceIndexed

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

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

Выбрасывает исключение, если этот массив пустой. Если массив может быть пустым ожидаемым образом, используйте reduceIndexedOrNull вместо этого. Он возвращает 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>.reduceIndexed(
    operation: (index: Int, acc: S, T) -> S
): S

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

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

© 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.collections/reduce-indexed.html

Spec-Zone.ru

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