Spec-Zone.ru › Kotlin 1.8

scanIndexed

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

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

Обратите внимание, что acc значение, переданное функции operation, не должно изменяться; в противном случае это повлияет на предыдущее значение в результирующем списке.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val strings = listOf("a", "b", "c", "d")
println(strings.scan("s") { acc, string -> acc + string }) // [s, sa, sab, sabc, sabcd]
println(strings.scanIndexed("s") { index, acc, string -> acc + string + index }) // [s, sa0, sa0b1, sa0b1c2, sa0b1c2d3]

println(emptyList<String>().scan("s") { _, _ -> "X" }) // [s]
//sampleEnd
}

Параметры

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

Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
inline fun <T, R> Iterable<T>.scanIndexed(
    initial: R, 
    operation: (index: Int, acc: R, T) -> R
): List<R>

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

Обратите внимание, что acc значение, переданное функции operation, не должно изменяться; в противном случае это повлияет на предыдущее значение в результирующем списке.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val strings = listOf("a", "b", "c", "d")
println(strings.scan("s") { acc, string -> acc + string }) // [s, sa, sab, sabc, sabcd]
println(strings.scanIndexed("s") { index, acc, string -> acc + string + index }) // [s, sa0, sa0b1, sa0b1c2, sa0b1c2d3]

println(emptyList<String>().scan("s") { _, _ -> "X" }) // [s]
//sampleEnd
}

Параметры

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

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

Spec-Zone.ru

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