take

Common

JVM

Native

1.0

fun CharSequence.take(n: Int): CharSequence

Returns a subsequence of this char sequence containing the first n characters from this char sequence, or the entire char sequence if this char sequence is shorter.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val string = "<<<First Grade>>>"
println(string.take(8)) // <<<First
println(string.takeLast(8)) // Grade>>>
println(string.takeWhile { !it.isLetter() }) // <<<
println(string.takeLastWhile { !it.isLetter() }) // >>>
//sampleEnd
}

Exceptions

IllegalArgumentException - if n is negative.

Common

JVM

Native

1.0

fun String.take(n: Int): String

Returns a string containing the first n characters from this string, or the entire string if this string is shorter.

import kotlin.test.*

fun main(args: Array<String>) {
//sampleStart
val string = "<<<First Grade>>>"
println(string.take(8)) // <<<First
println(string.takeLast(8)) // Grade>>>
println(string.takeWhile { !it.isLetter() }) // <<<
println(string.takeLastWhile { !it.isLetter() }) // >>>
//sampleEnd
}

Exceptions

IllegalArgumentException - if n is negative.