windowed

Начиная с Kotlin: 1.2

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

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

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

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

Параметры

size

количество элементов, включаемых в каждое окно

step

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

partialWindows

определяет, сохранять ли неполные окна в конце, если они есть; по умолчанию false, то есть неполные окна не сохраняются

Примеры

import kotlin.test.*

fun main() { 
   //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
}

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

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

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