Spec-Zone.ru › Kotlin 2

insert

kotlin-stdlib/kotlin.text/insert

Требования к платформе и версии: Common (1.9)

@IgnorableReturnValue
expect fun StringBuilder.insert(index: Int, value: Byte): StringBuilder

Вставляет строковое представление указанного байтового значения в этот построитель строк по указанному индексу и возвращает этот экземпляр.

Общий эффект в точности такой же, как если бы значение было преобразовано в строку методом value.toString(), а затем эта строка была вставлена в этот построитель строк по указанному индексу.

Исключения

IndexOutOfBoundsException

если index меньше нуля или больше длины этого построителя строк.


@IgnorableReturnValue
expect fun StringBuilder.insert(index: Int, value: Short): StringBuilder

Вставляет строковое представление указанного короткого значения в этот построитель строк по указанному индексу и возвращает этот экземпляр.

Общий эффект в точности такой же, как если бы значение было преобразовано в строку методом value.toString(), а затем эта строка была вставлена в этот построитель строк по указанному индексу.

Исключения

IndexOutOfBoundsException

если index меньше нуля или больше длины этого построителя строк.

Требования к платформе и версии: JS (1.9), JVM (1.9)

@IgnorableReturnValue
actual inline fun StringBuilder.insert(index: Int, value: Byte): StringBuilder

Вставляет строковое представление указанного байтового значения в этот построитель строк по указанному индексу и возвращает этот экземпляр.

Общий эффект в точности такой же, как если бы значение было преобразовано в строку методом value.toString(), а затем эта строка была вставлена в этот построитель строк по указанному индексу.

Исключения

IndexOutOfBoundsException

если index меньше нуля или больше длины этого построителя строк.


@IgnorableReturnValue
actual inline fun StringBuilder.insert(index: Int, value: Short): StringBuilder

Вставляет строковое представление указанного короткого значения в этот построитель строк по указанному индексу и возвращает этот экземпляр.

Общий эффект в точности такой же, как если бы значение было преобразовано в строку методом value.toString(), а затем эта строка была вставлена в этот построитель строк по указанному индексу.

Исключения

IndexOutOfBoundsException

если index меньше нуля или больше длины этого построителя строк.

Требования к платформе и версии: Native (1.9), Wasm-JS (1.9), Wasm-WASI (1.9)

@IgnorableReturnValue
actual inline fun StringBuilder.insert(index: Int, value: Byte): StringBuilder

Вставляет строковое представление указанного байтового значения в этот построитель строк по указанному индексу и возвращает этот экземпляр.

Общий эффект в точности такой же, как если бы значение было преобразовано в строку методом value.toString(), а затем эта строка была вставлена в этот построитель строк по указанному индексу.

Исключения

IndexOutOfBoundsException

если index меньше нуля или больше длины этого построителя строк.


@IgnorableReturnValue
actual inline fun StringBuilder.insert(index: Int, value: Short): StringBuilder

Вставляет строковое представление указанного короткого значения в этот построитель строк по указанному индексу и возвращает этот экземпляр.

Общий эффект в точности такой же, как если бы значение было преобразовано в строку методом value.toString(), а затем эта строка была вставлена в этот построитель строк по указанному индексу.

Исключения

IndexOutOfBoundsException

если index меньше нуля или больше длины этого построителя строк.


inline fun StringBuilder.insert(index: Int, csq: CharSequence?, start: Int, end: Int): StringBuilder

Устарело

Предупреждение начиная с версии 1.4

Ошибка начиная с версии 1.6

Вместо этого используйте insertRange(index: Int, csq: CharSequence, start: Int, end: Int)

Заменить на

insertRange(index, csq ?: "null", start, end)

Вставляет символы из подпоследовательности указанной символьной последовательности csq в этот построитель строк по указанному индексу и возвращает этот экземпляр.

Вставляемые символы располагаются в том же порядке, что и в символьной последовательности csq, начиная с index.

Параметры

index

позиция в этом построителе строк, в которую выполняется вставка.

csq

символьная последовательность, из которой вставляется подпоследовательность. Если csq равно null, символы будут вставлены так, как если бы csq содержало четыре символа "null".

start

начало (включительно) вставляемой подпоследовательности.

end

конец (не включительно) вставляемой подпоследовательности.

Исключения

IndexOutOfBoundsException

если index меньше нуля или больше длины этого построителя строк.

© 2010–2026 JetBrains s.r.o. and Kotlin Programming Language contributors
Licensed under the Apache License, Version 2.0.
https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.text/insert.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API