W3cubDocs

/Kotlin

zipWithNext

Platform and version requirements: JVM (1.2), JS (1.2), Native (1.2)
fun <T> Sequence<T>.zipWithNext(): Sequence<Pair<T, T>>

Returns a sequence of pairs of each two adjacent elements in this sequence.

The returned sequence is empty if this sequence contains less than two elements.

The operation is intermediate and stateless.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val letters = ('a'..'f').toList()
val pairs = letters.zipWithNext()

println(letters) // [a, b, c, d, e, f]
println(pairs) // [(a, b), (b, c), (c, d), (d, e), (e, f)]
//sampleEnd
}
Platform and version requirements: JVM (1.2), JS (1.2), Native (1.2)
fun <T, R> Sequence<T>.zipWithNext(
    transform: (a: T, b: T) -> R
): Sequence<R>

Returns a sequence containing the results of applying the given transform function to an each pair of two adjacent elements in this sequence.

The returned sequence is empty if this sequence contains less than two elements.

The operation is intermediate and stateless.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val values = listOf(1, 4, 9, 16, 25, 36)
val deltas = values.zipWithNext { a, b -> b - a }

println(deltas) // [3, 5, 7, 9, 11]
//sampleEnd
}

© 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/zip-with-next.html