windowed

kotlin-stdlib/kotlin.collections/windowed

Начиная с Kotlin: 1.2

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

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

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

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

Параметры

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> Iterable<T>.windowed(size: Int, step: Int = 1, partialWindows: Boolean = false, transform: (List<T>) -> R): List<R>

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

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