Spec-Zone.ru › Kotlin 1.7

scan

kotlin-stdlib / kotlin.sequences / scan
Требования к платформе и версии: JVM (1.4), JS (1.4), Native (1.4)
fun <T, R> Sequence<T>.scan(
    initial: R, 
    operation: (acc: R, T) -> R
): Sequence<R>

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

Обратите внимание, что значение, переданное функции operation, не должно изменяться; в противном случае это повлияет на предыдущее значение в результирующей последовательности. Значение initial также должно быть неизменяемым (или не должно изменяться), поскольку оно может быть передано функции 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–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/scan.html

Spec-Zone.ru

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