W3cubDocs

/Kotlin

zip

kotlin-stdlib / kotlin.collections / zip
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
infix fun <T, R> Array<out T>.zip(
    other: Array<out R>
): List<Pair<T, R>>
infix fun <R> ByteArray.zip(
    other: Array<out R>
): List<Pair<Byte, R>>
infix fun <R> ShortArray.zip(
    other: Array<out R>
): List<Pair<Short, R>>
infix fun <R> IntArray.zip(
    other: Array<out R>
): List<Pair<Int, R>>
infix fun <R> LongArray.zip(
    other: Array<out R>
): List<Pair<Long, R>>
infix fun <R> FloatArray.zip(
    other: Array<out R>
): List<Pair<Float, R>>
infix fun <R> DoubleArray.zip(
    other: Array<out R>
): List<Pair<Double, R>>
infix fun <R> BooleanArray.zip(
    other: Array<out R>
): List<Pair<Boolean, R>>
infix fun <R> CharArray.zip(
    other: Array<out R>
): List<Pair<Char, R>>
infix fun ByteArray.zip(
    other: ByteArray
): List<Pair<Byte, Byte>>
infix fun ShortArray.zip(
    other: ShortArray
): List<Pair<Short, Short>>
infix fun IntArray.zip(other: IntArray): List<Pair<Int, Int>>
infix fun LongArray.zip(
    other: LongArray
): List<Pair<Long, Long>>
infix fun FloatArray.zip(
    other: FloatArray
): List<Pair<Float, Float>>
infix fun DoubleArray.zip(
    other: DoubleArray
): List<Pair<Double, Double>>
infix fun BooleanArray.zip(
    other: BooleanArray
): List<Pair<Boolean, Boolean>>
infix fun CharArray.zip(
    other: CharArray
): List<Pair<Char, Char>>
@ExperimentalUnsignedTypes infix fun <R> UIntArray.zip(
    other: Array<out R>
): List<Pair<UInt, R>>
@ExperimentalUnsignedTypes infix fun <R> ULongArray.zip(
    other: Array<out R>
): List<Pair<ULong, R>>
@ExperimentalUnsignedTypes infix fun <R> UByteArray.zip(
    other: Array<out R>
): List<Pair<UByte, R>>
@ExperimentalUnsignedTypes infix fun <R> UShortArray.zip(
    other: Array<out R>
): List<Pair<UShort, R>>
@ExperimentalUnsignedTypes infix fun UIntArray.zip(
    other: UIntArray
): List<Pair<UInt, UInt>>
@ExperimentalUnsignedTypes infix fun ULongArray.zip(
    other: ULongArray
): List<Pair<ULong, ULong>>
@ExperimentalUnsignedTypes infix fun UByteArray.zip(
    other: UByteArray
): List<Pair<UByte, UByte>>
@ExperimentalUnsignedTypes infix fun UShortArray.zip(
    other: UShortArray
): List<Pair<UShort, UShort>>

Returns a list of pairs built from the elements of this array and the other array with the same index. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
println(listA zip listB) // [(a, 1), (b, 2), (c, 3)]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
inline fun <T, R, V> Array<out T>.zip(
    other: Array<out R>, 
    transform: (a: T, b: R) -> V
): List<V>
inline fun <R, V> ByteArray.zip(
    other: Array<out R>, 
    transform: (a: Byte, b: R) -> V
): List<V>
inline fun <R, V> ShortArray.zip(
    other: Array<out R>, 
    transform: (a: Short, b: R) -> V
): List<V>
inline fun <R, V> IntArray.zip(
    other: Array<out R>, 
    transform: (a: Int, b: R) -> V
): List<V>
inline fun <R, V> LongArray.zip(
    other: Array<out R>, 
    transform: (a: Long, b: R) -> V
): List<V>
inline fun <R, V> FloatArray.zip(
    other: Array<out R>, 
    transform: (a: Float, b: R) -> V
): List<V>
inline fun <R, V> DoubleArray.zip(
    other: Array<out R>, 
    transform: (a: Double, b: R) -> V
): List<V>
inline fun <R, V> BooleanArray.zip(
    other: Array<out R>, 
    transform: (a: Boolean, b: R) -> V
): List<V>
inline fun <R, V> CharArray.zip(
    other: Array<out R>, 
    transform: (a: Char, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> UIntArray.zip(
    other: Array<out R>, 
    transform: (a: UInt, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> ULongArray.zip(
    other: Array<out R>, 
    transform: (a: ULong, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> UByteArray.zip(
    other: Array<out R>, 
    transform: (a: UByte, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> UShortArray.zip(
    other: Array<out R>, 
    transform: (a: UShort, b: R) -> V
): List<V>

Returns a list of values built from the elements of this array and the other array with the same index using the provided transform function applied to each pair of elements. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
val result = listA.zip(listB) { a, b -> "$a$b" }
println(result) // [a1, b2, c3]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
infix fun <T, R> Array<out T>.zip(
    other: Iterable<R>
): List<Pair<T, R>>
infix fun <R> ByteArray.zip(
    other: Iterable<R>
): List<Pair<Byte, R>>
infix fun <R> ShortArray.zip(
    other: Iterable<R>
): List<Pair<Short, R>>
infix fun <R> IntArray.zip(
    other: Iterable<R>
): List<Pair<Int, R>>
infix fun <R> LongArray.zip(
    other: Iterable<R>
): List<Pair<Long, R>>
infix fun <R> FloatArray.zip(
    other: Iterable<R>
): List<Pair<Float, R>>
infix fun <R> DoubleArray.zip(
    other: Iterable<R>
): List<Pair<Double, R>>
infix fun <R> BooleanArray.zip(
    other: Iterable<R>
): List<Pair<Boolean, R>>
infix fun <R> CharArray.zip(
    other: Iterable<R>
): List<Pair<Char, R>>
@ExperimentalUnsignedTypes infix fun <R> UIntArray.zip(
    other: Iterable<R>
): List<Pair<UInt, R>>
@ExperimentalUnsignedTypes infix fun <R> ULongArray.zip(
    other: Iterable<R>
): List<Pair<ULong, R>>
@ExperimentalUnsignedTypes infix fun <R> UByteArray.zip(
    other: Iterable<R>
): List<Pair<UByte, R>>
@ExperimentalUnsignedTypes infix fun <R> UShortArray.zip(
    other: Iterable<R>
): List<Pair<UShort, R>>

Returns a list of pairs built from the elements of this collection and other array with the same index. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
println(listA zip listB) // [(a, 1), (b, 2), (c, 3)]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
inline fun <T, R, V> Array<out T>.zip(
    other: Iterable<R>, 
    transform: (a: T, b: R) -> V
): List<V>
inline fun <R, V> ByteArray.zip(
    other: Iterable<R>, 
    transform: (a: Byte, b: R) -> V
): List<V>
inline fun <R, V> ShortArray.zip(
    other: Iterable<R>, 
    transform: (a: Short, b: R) -> V
): List<V>
inline fun <R, V> IntArray.zip(
    other: Iterable<R>, 
    transform: (a: Int, b: R) -> V
): List<V>
inline fun <R, V> LongArray.zip(
    other: Iterable<R>, 
    transform: (a: Long, b: R) -> V
): List<V>
inline fun <R, V> FloatArray.zip(
    other: Iterable<R>, 
    transform: (a: Float, b: R) -> V
): List<V>
inline fun <R, V> DoubleArray.zip(
    other: Iterable<R>, 
    transform: (a: Double, b: R) -> V
): List<V>
inline fun <R, V> BooleanArray.zip(
    other: Iterable<R>, 
    transform: (a: Boolean, b: R) -> V
): List<V>
inline fun <R, V> CharArray.zip(
    other: Iterable<R>, 
    transform: (a: Char, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> UIntArray.zip(
    other: Iterable<R>, 
    transform: (a: UInt, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> ULongArray.zip(
    other: Iterable<R>, 
    transform: (a: ULong, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> UByteArray.zip(
    other: Iterable<R>, 
    transform: (a: UByte, b: R) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <R, V> UShortArray.zip(
    other: Iterable<R>, 
    transform: (a: UShort, b: R) -> V
): List<V>

Returns a list of values built from the elements of this array and the other collection with the same index using the provided transform function applied to each pair of elements. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
val result = listA.zip(listB) { a, b -> "$a$b" }
println(result) // [a1, b2, c3]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
inline fun <V> ByteArray.zip(
    other: ByteArray, 
    transform: (a: Byte, b: Byte) -> V
): List<V>
inline fun <V> ShortArray.zip(
    other: ShortArray, 
    transform: (a: Short, b: Short) -> V
): List<V>
inline fun <V> IntArray.zip(
    other: IntArray, 
    transform: (a: Int, b: Int) -> V
): List<V>
inline fun <V> LongArray.zip(
    other: LongArray, 
    transform: (a: Long, b: Long) -> V
): List<V>
inline fun <V> FloatArray.zip(
    other: FloatArray, 
    transform: (a: Float, b: Float) -> V
): List<V>
inline fun <V> DoubleArray.zip(
    other: DoubleArray, 
    transform: (a: Double, b: Double) -> V
): List<V>
inline fun <V> BooleanArray.zip(
    other: BooleanArray, 
    transform: (a: Boolean, b: Boolean) -> V
): List<V>
inline fun <V> CharArray.zip(
    other: CharArray, 
    transform: (a: Char, b: Char) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <V> UIntArray.zip(
    other: UIntArray, 
    transform: (a: UInt, b: UInt) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <V> ULongArray.zip(
    other: ULongArray, 
    transform: (a: ULong, b: ULong) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <V> UByteArray.zip(
    other: UByteArray, 
    transform: (a: UByte, b: UByte) -> V
): List<V>
@ExperimentalUnsignedTypes inline fun <V> UShortArray.zip(
    other: UShortArray, 
    transform: (a: UShort, b: UShort) -> V
): List<V>

Returns a list of values built from the elements of this array and the other array with the same index using the provided transform function applied to each pair of elements. The returned list has length of the shortest array.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
val result = listA.zip(listB) { a, b -> "$a$b" }
println(result) // [a1, b2, c3]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
infix fun <T, R> Iterable<T>.zip(
    other: Array<out R>
): List<Pair<T, R>>

Returns a list of pairs built from the elements of this collection and the other array with the same index. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
println(listA zip listB) // [(a, 1), (b, 2), (c, 3)]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
inline fun <T, R, V> Iterable<T>.zip(
    other: Array<out R>, 
    transform: (a: T, b: R) -> V
): List<V>

Returns a list of values built from the elements of this collection and the other array with the same index using the provided transform function applied to each pair of elements. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
val result = listA.zip(listB) { a, b -> "$a$b" }
println(result) // [a1, b2, c3]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
infix fun <T, R> Iterable<T>.zip(
    other: Iterable<R>
): List<Pair<T, R>>

Returns a list of pairs built from the elements of this collection and other collection with the same index. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
println(listA zip listB) // [(a, 1), (b, 2), (c, 3)]
//sampleEnd
}
Platform and version requirements: JVM (1.0), JS (1.0), Native (1.0) 
inline fun <T, R, V> Iterable<T>.zip(
    other: Iterable<R>, 
    transform: (a: T, b: R) -> V
): List<V>

Returns a list of values built from the elements of this collection and the other collection with the same index using the provided transform function applied to each pair of elements. The returned list has length of the shortest collection.



fun main(args: Array<String>) {
//sampleStart
val listA = listOf("a", "b", "c")
val listB = listOf(1, 2, 3, 4)
val result = listA.zip(listB) { a, b -> "$a$b" }
println(result) // [a1, b2, c3]
//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.collections/zip.html