zipWithNext

fun CharSequence.zipWithNext(): List<Pair<Char, Char>>(source)

Returns a list of pairs of each two adjacent characters in this char sequence.

The returned list is empty if this char sequence contains less than two characters.

Since Kotlin

1.2

Samples

import kotlin.test.*

fun main() { 
   //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
}
xxxxxxxxxx
 
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)] 
Open in Playground →
Target: JVMRunning on v.2.1.20

inline fun <R> CharSequence.zipWithNext(transform: (a: Char, b: Char) -> R): List<R>(source)

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

The returned list is empty if this char sequence contains less than two characters.

Since Kotlin

1.2

Samples

import kotlin.test.*

fun main() { 
   //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
}
xxxxxxxxxx
 
val values = listOf(1, 4, 9, 16, 25, 36)
val deltas = values.zipWithNext { a, b -> b - a }
println(deltas) // [3, 5, 7, 9, 11] 
Open in Playground →
Target: JVMRunning on v.2.1.20

Thanks for your feedback!

Was this page helpful?