take

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.

Samples

import samples.*
import java.util.Locale
import kotlin.test.*
fun main() { 
   //sampleStart 
   val string = "<<<First Grade>>>"
assertPrints(string.take(8), "<<<First")
assertPrints(string.takeLast(8), "Grade>>>")
assertPrints(string.takeWhile { !it.isLetter() }, "<<<")
assertPrints(string.takeLastWhile { !it.isLetter() }, ">>>") 
   //sampleEnd
}

Throws

kotlin.IllegalArgumentException

if n is negative.

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.

Samples

import samples.*
import java.util.Locale
import kotlin.test.*
fun main() { 
   //sampleStart 
   val string = "<<<First Grade>>>"
assertPrints(string.take(8), "<<<First")
assertPrints(string.takeLast(8), "Grade>>>")
assertPrints(string.takeWhile { !it.isLetter() }, "<<<")
assertPrints(string.takeLastWhile { !it.isLetter() }, ">>>") 
   //sampleEnd
}

Throws

kotlin.IllegalArgumentException

if n is negative.