take

fun <T> Array<out T>.take(n: Int): List<T>

fun ByteArray.take(n: Int): List<Byte>

fun ShortArray.take(n: Int): List<Short>

fun IntArray.take(n: Int): List<Int>

fun LongArray.take(n: Int): List<Long>

fun FloatArray.take(n: Int): List<Float>

fun DoubleArray.take(n: Int): List<Double>

fun BooleanArray.take(n: Int): List<Boolean>

fun CharArray.take(n: Int): List<Char>

fun <T> Iterable<T>.take(n: Int): List<T>

Returns a list containing first n elements.

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val chars = ('a'..'z').toList()
assertPrints(chars.take(3), "[a, b, c]")
assertPrints(chars.takeWhile { it < 'f' }, "[a, b, c, d, e]")
assertPrints(chars.takeLast(2), "[y, z]")
assertPrints(chars.takeLastWhile { it > 'w' }, "[x, y, z]") 
   //sampleEnd
}

Throws

kotlin.IllegalArgumentException

if n is negative.

@ExperimentalUnsignedTypes

fun UIntArray.take(n: Int): List<UInt>

@ExperimentalUnsignedTypes

fun ULongArray.take(n: Int): List<ULong>

@ExperimentalUnsignedTypes

fun UByteArray.take(n: Int): List<UByte>

@ExperimentalUnsignedTypes

fun UShortArray.take(n: Int): List<UShort>

Returns a list containing first n elements.

Since Kotlin

1.3

Samples

import samples.*
import kotlin.test.*
fun main() { 
   //sampleStart 
   val chars = ('a'..'z').toList()
assertPrints(chars.take(3), "[a, b, c]")
assertPrints(chars.takeWhile { it < 'f' }, "[a, b, c, d, e]")
assertPrints(chars.takeLast(2), "[y, z]")
assertPrints(chars.takeLastWhile { it > 'w' }, "[x, y, z]") 
   //sampleEnd
}

Throws

kotlin.IllegalArgumentException

if n is negative.