insert

Common
JS
Native
1.9
fun StringBuilder.insert(
    index: Int,
    value: Byte
): StringBuilder

(Common source) (JS source) (Native source)

Inserts the string representation of the specified byte value into this string builder at the specified index and returns this instance.

The overall effect is exactly as if the value were converted to a string by the value.toString() method, and then that string was inserted into this string builder at the specified index.

Exceptions

IndexOutOfBoundsException - if index is less than zero or greater than the length of this string builder.

Common
JS
Native
1.9
fun StringBuilder.insert(
    index: Int,
    value: Short
): StringBuilder

(Common source) (JS source) (Native source)

Inserts the string representation of the specified short value into this string builder at the specified index and returns this instance.

The overall effect is exactly as if the value were converted to a string by the value.toString() method, and then that string was inserted into this string builder at the specified index.

Exceptions

IndexOutOfBoundsException - if index is less than zero or greater than the length of this string builder.

Native
1.3
@DeprecatedSinceKotlin("1.4", "1.6") fun StringBuilder.insert(
    index: Int,
    csq: CharSequence?,
    start: Int,
    end: Int
): StringBuilder

(source)
Deprecated: Use insertRange(index: Int, csq: CharSequence, start: Int, end: Int) instead

Inserts characters in a subsequence of the specified character sequence csq into this string builder at the specified index and returns this instance.

The inserted characters go in the same order as in the csq character sequence, starting at index.

Parameters

index - the position in this string builder to insert at.

csq - the character sequence from which a subsequence is inserted. If csq is null, then characters will be inserted as if csq contained the four characters "null".

start - the beginning (inclusive) of the subsequence to insert.

end - the end (exclusive) of the subsequence to insert.

Exceptions

IndexOutOfBoundsException - or IllegalArgumentException when start or end is out of range of the csq character sequence indices or when start > end.

IndexOutOfBoundsException - if index is less than zero or greater than the length of this string builder.