kotlin-stdlib / kotlin.text / appendRange

appendRange

Common
JVM
JS
Native
1.3
@ExperimentalStdlibApi fun <T : Appendable> T.appendRange(
    value: CharSequence?,
    startIndex: Int,
    endIndex: Int
): T

Appends a subsequence of the specified character sequence value to this Appendable and returns this instance.

Parameters

value - the character sequence from which a subsequence is appended. If value is null, then characters are appended as if value contained the four characters "null".

startIndex - the beginning (inclusive) of the subsequence to append.

endIndex - the end (exclusive) of the subsequence to append.

Exceptions

IndexOutOfBoundsException - or IllegalArgumentException when startIndex or endIndex is out of range of the value character sequence indices or when startIndex > endIndex.

Common
JS
Native
1.3
@ExperimentalStdlibApi fun StringBuilder.appendRange(
    value: CharArray,
    startIndex: Int,
    endIndex: Int
): StringBuilder

Appends characters in a subarray of the specified character array value to this string builder and returns this instance.

Characters are appended in order, starting at specified startIndex.

Parameters

value - the array from which characters are appended.

startIndex - the beginning (inclusive) of the subarray to append.

endIndex - the end (exclusive) of the subarray to append.

Exceptions

IndexOutOfBoundsException - or IllegalArgumentException when startIndex or endIndex is out of range of the value array indices or when startIndex > endIndex.

Common
JS
Native
1.3
@ExperimentalStdlibApi fun StringBuilder.appendRange(
    value: CharSequence?,
    startIndex: Int,
    endIndex: Int
): StringBuilder

Appends a subsequence of the specified character sequence value to this string builder and returns this instance.

Parameters

value - the character sequence from which a subsequence is appended. If value is null, then characters are appended as if value contained the four characters "null".

startIndex - the beginning (inclusive) of the subsequence to append.

endIndex - the end (exclusive) of the subsequence to append.

Exceptions

IndexOutOfBoundsException - or IllegalArgumentException when startIndex or endIndex is out of range of the value character sequence indices or when startIndex > endIndex.