kotlin-stdlib/kotlin.collections/takeWhile

takeWhile

inline fun <T> Array<out T>.takeWhile(predicate: (T) -> Boolean): List<T>(source)

inline fun ByteArray.takeWhile(predicate: (Byte) -> Boolean): List<Byte>(source)

inline fun ShortArray.takeWhile(predicate: (Short) -> Boolean): List<Short>(source)

inline fun IntArray.takeWhile(predicate: (Int) -> Boolean): List<Int>(source)

inline fun LongArray.takeWhile(predicate: (Long) -> Boolean): List<Long>(source)

inline fun FloatArray.takeWhile(predicate: (Float) -> Boolean): List<Float>(source)

inline fun DoubleArray.takeWhile(predicate: (Double) -> Boolean): List<Double>(source)

inline fun BooleanArray.takeWhile(predicate: (Boolean) -> Boolean): List<Boolean>(source)

inline fun CharArray.takeWhile(predicate: (Char) -> Boolean): List<Char>(source)

inline fun <T> Iterable<T>.takeWhile(predicate: (T) -> Boolean): List<T>(source)

Returns a list containing first elements satisfying the given predicate.

Since Kotlin

1.0

Samples

import kotlin.test.*

fun main() { 
   //sampleStart 
   val chars = ('a'..'z').toList()
println(chars.take(3)) // [a, b, c]
println(chars.takeWhile { it < 'f' }) // [a, b, c, d, e]
println(chars.takeLast(2)) // [y, z]
println(chars.takeLastWhile { it > 'w' }) // [x, y, z] 
   //sampleEnd
}
xxxxxxxxxx
 
val chars = ('a'..'z').toList()
println(chars.take(3)) // [a, b, c]
println(chars.takeWhile { it < 'f' }) // [a, b, c, d, e]
println(chars.takeLast(2)) // [y, z]
println(chars.takeLastWhile { it > 'w' }) // [x, y, z] 
Open in Playground →
Target: JVMRunning on v.2.1.20

@ExperimentalUnsignedTypes

inline fun UIntArray.takeWhile(predicate: (UInt) -> Boolean): List<UInt>(source)

@ExperimentalUnsignedTypes

inline fun ULongArray.takeWhile(predicate: (ULong) -> Boolean): List<ULong>(source)

@ExperimentalUnsignedTypes

inline fun UByteArray.takeWhile(predicate: (UByte) -> Boolean): List<UByte>(source)

@ExperimentalUnsignedTypes

inline fun UShortArray.takeWhile(predicate: (UShort) -> Boolean): List<UShort>(source)

Returns a list containing first elements satisfying the given predicate.

Since Kotlin

1.3

Samples

import kotlin.test.*

fun main() { 
   //sampleStart 
   val chars = ('a'..'z').toList()
println(chars.take(3)) // [a, b, c]
println(chars.takeWhile { it < 'f' }) // [a, b, c, d, e]
println(chars.takeLast(2)) // [y, z]
println(chars.takeLastWhile { it > 'w' }) // [x, y, z] 
   //sampleEnd
}
xxxxxxxxxx
 
val chars = ('a'..'z').toList()
println(chars.take(3)) // [a, b, c]
println(chars.takeWhile { it < 'f' }) // [a, b, c, d, e]
println(chars.takeLast(2)) // [y, z]
println(chars.takeLastWhile { it > 'w' }) // [x, y, z] 
Open in Playground →
Target: JVMRunning on v.2.1.20

Thanks for your feedback!

Was this page helpful?