windowed

fun <T> Sequence<T>.windowed(
    size: Int, 
    step: Int = 1, 
    partialWindows: Boolean = false
): Sequence<List<T>>

Возвращает последовательность снимков окна заданного размера, скользящего по этой последовательности с заданным шагом, где каждый снимок — список.

Несколько последних списков могут содержать меньше элементов, чем заданный размер.

И размер, и шаг должны быть положительными и могут быть больше количества элементов в этой последовательности.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val sequence = generateSequence(1) { it + 1 }

val windows = sequence.windowed(size = 5, step = 1)
println(windows.take(4).toList()) // [[1, 2, 3, 4, 5], [2, 3, 4, 5, 6], [3, 4, 5, 6, 7], [4, 5, 6, 7, 8]]

val moreSparseWindows = sequence.windowed(size = 5, step = 3)
println(moreSparseWindows.take(4).toList()) // [[1, 2, 3, 4, 5], [4, 5, 6, 7, 8], [7, 8, 9, 10, 11], [10, 11, 12, 13, 14]]

val fullWindows = sequence.take(10).windowed(size = 5, step = 3)
println(fullWindows.toList()) // [[1, 2, 3, 4, 5], [4, 5, 6, 7, 8]]

val partialWindows = sequence.take(10).windowed(size = 5, step = 3, partialWindows = true)
println(partialWindows.toList()) // [[1, 2, 3, 4, 5], [4, 5, 6, 7, 8], [7, 8, 9, 10], [10]]
//sampleEnd
}

Параметры

size - количество элементов в каждом окне

step - количество элементов, на которое смещается окно на каждом шаге, по умолчанию 1

partialWindows - управляет сохранением частичных окон в конце, если таковые имеются, по умолчанию false, что означает, что частичные окна не сохраняются

fun <T, R> Sequence<T>.windowed(
    size: Int, 
    step: Int = 1, 
    partialWindows: Boolean = false, 
    transform: (List<T>) -> R
): Sequence<R>

Возвращает последовательность результатов применения заданной функции transform к каждому списку, представляющему собой вид на окно заданного размера, скользящего по этой последовательности с заданным шагом.

Обратите внимание, что список, переданный функции transform, является временным и действителен только внутри этой функции. Вы не должны сохранять его или каким-либо образом допускать его выход за пределы функции, если вы не сделали его снимок.

Несколько последних списков могут содержать меньше элементов, чем заданный размер.

И размер, и шаг должны быть положительными и могут быть больше количества элементов в этой последовательности.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val dataPoints = sequenceOf(10, 15, 18, 25, 19, 21, 14, 8, 5)

val averaged = dataPoints.windowed(size = 4, step = 1, partialWindows = true) { window -> window.average() }
println(averaged.toList()) // [17.0, 19.25, 20.75, 19.75, 15.5, 12.0, 9.0, 6.5, 5.0]

val averagedNoPartialWindows = dataPoints.windowed(size = 4, step = 1).map { it.average() }
println(averagedNoPartialWindows.toList()) // [17.0, 19.25, 20.75, 19.75, 15.5, 12.0]
//sampleEnd
}

Параметры

size - количество элементов в каждом окне

step - количество элементов, на которое смещается окно на каждом шаге, по умолчанию 1

partialWindows - управляет сохранением частичных окон в конце, если таковые имеются, по умолчанию false, что означает, что частичные окна не сохраняются