toCharArray

Common
JS
1.3
@ExperimentalStdlibApi fun String.toCharArray(): CharArray
JVM
Native
1.0
fun String.toCharArray(): CharArray

Returns a CharArray containing characters of this string.

Common
JVM
JS
1.3
@ExperimentalStdlibApi fun String.toCharArray(
    startIndex: Int = 0,
    endIndex: Int = this.length
): CharArray
Native
1.3
fun String.toCharArray(
    startIndex: Int,
    endIndex: Int
): CharArray

Returns a CharArray containing characters of this string or its substring.

Parameters

startIndex - the beginning (inclusive) of the substring, 0 by default.

endIndex - the end (exclusive) of the substring, length of this string by default.

Exceptions

IndexOutOfBoundsException - if startIndex is less than zero or endIndex is greater than the length of this string.

IllegalArgumentException - if startIndex is greater than endIndex.

Common
JS
Native
1.3
@ExperimentalStdlibApi fun StringBuilder.toCharArray(
    destination: CharArray,
    destinationOffset: Int = 0,
    startIndex: Int = 0,
    endIndex: Int = this.length)

Copies characters from this string builder into the destination character array.

Parameters

destination - the array to copy to.

destinationOffset - the position in the array to copy to, 0 by default.

startIndex - the beginning (inclusive) of the range to copy, 0 by default.

endIndex - the end (exclusive) of the range to copy, length of this string builder by default.

Exceptions

IndexOutOfBoundsException - or IllegalArgumentException when startIndex or endIndex is out of range of this string builder indices or when startIndex > endIndex.

IndexOutOfBoundsException - when the subrange doesn't fit into the destination array starting at the specified destinationOffset, or when that index is out of the destination array indices range.

JVM
1.0
fun String.toCharArray(
    destination: CharArray,
    destinationOffset: Int = 0,
    startIndex: Int = 0,
    endIndex: Int = length
): CharArray

Copies characters from this string into the destination character array and returns that array.

Parameters

destination - the array to copy to.

destinationOffset - the position in the array to copy to.

startIndex - the start offset (inclusive) of the substring to copy.

endIndex - the end offset (exclusive) of the substring to copy.