Функция appendRange

Функция appendRange добавляет в текущий объект StringBuilder указанный диапазон символов из переданного массива CharArray. Диапазон задается начальным индексом startIndex и конечным индексом endIndex.

Синтаксис

fun appendRange(
    chars: CharArray, 
    startIndex: Int, 
    endIndex: Int
): StringBuilder

Параметры

chars: CharArray - массив символов, из которого нужно добавить диапазон.

startIndex: Int - начальный индекс диапазона (включительно).

endIndex: Int - конечный индекс диапазона (исключительно).

Возвращаемое значение

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

Пример

Добавим диапазон символов из массива:

val sb = StringBuilder("Text: ")
val charArray = charArrayOf('a', 'b', 'c', 'd', 'e')

sb.appendRange(charArray, 1, 4)
println(sb.toString())

Результат выполнения кода:

String "Text: bcd"

Пример

Использование цепочки вызовов:

val charArray = charArrayOf('1', '2', '3', '4', '5')
val res = StringBuilder()
    .append("Numbers: ")
    .appendRange(charArray, 0, 3)
    .append(" | ")
    .appendRange(charArray, 3, 5)
    .toString()

println(res)

Результат выполнения кода:

String "Numbers: 123 | 45"

Пример

Добавление пустого диапазона:

val sb = StringBuilder("Start")
val charArray = charArrayOf('a', 'b', 'c')

sb.appendRange(charArray, 1, 1)
println(sb.toString())

Результат выполнения кода:

String "Start"

Исключения

Метод может выбрасывать исключения:

val sb = StringBuilder()
val charArray = charArrayOf('a', 'b', 'c')

// IndexOutOfBoundsException
sb.appendRange(charArray, -1, 2)

val sb = StringBuilder()
val charArray = charArrayOf('a', 'b', 'c')

// IndexOutOfBoundsException
sb.appendRange(charArray, 1, 5)

val sb = StringBuilder()
val charArray = charArrayOf('a', 'b', 'c')

// IllegalArgumentException
sb.appendRange(charArray, 2, 1)

Смотрите также

функцию append,
которая добавляет различные типы данных
функцию insert,
которая вставляет данные в определенную позицию
функцию deleteRange,
которая удаляет диапазон символов
функцию substring,
которая возвращает подстроку из StringBuilder