Функция toCharArray

Функция toCharArray преобразует содержимое StringBuilder в массив символов CharArray. Может использоваться для получения копии данных в виде массива, для передачи в функции, работающие с массивами символов, или для модификации символов без изменения исходного StringBuilder.

Синтаксис

kotlinfun toCharArray(): CharArray

kotlinfun toCharArray(
  destination: CharArray,
  destinationOffset: Int = 0,
  startIndex: Int = 0,
  endIndex: Int = length
)

Пример

Преобразуем StringBuilder в массив символов:

kotlinval sb = StringBuilder("abcde")
val charArray: CharArray = sb.toCharArray()
println(charArray.contentToString())

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

kotlinCharArray ['a', 'b', 'c', 'd', 'e']

Пример

Использование функции с параметрами для копирования части StringBuilder в существующий массив:

kotlinval sb = StringBuilder("12345")
val destArray = CharArray(3)

sb.toCharArray(
  destination = destArray,
  startIndex = 1,
  endIndex = 4
)

println(destArray.contentToString())

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

kotlinCharArray ['2', '3', '4']

Пример

Копирование с указанием смещения в целевом массиве:

kotlinval sb = StringBuilder("abcde")
val destArray = CharArray(5) { '-' }

sb.toCharArray(
  destination = destArray,
  destinationOffset = 1,
  startIndex = 0,
  endIndex = 3
)

println(destArray.contentToString())

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

kotlinCharArray ['-', 'a', 'b', 'c', '-']

Параметры

destination - массив символов, в который будет скопировано содержимое StringBuilder.

destinationOffset - позиция в целевом массиве, с которой начинается копирование (по умолчанию 0).

startIndex - начальный индекс в StringBuilder (включительно, по умолчанию 0).

endIndex - конечный индекс в StringBuilder (исключительно, по умолчанию length).

Исключения

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

kotlinIndexOutOfBoundsException - если индексы выходят за границы
IllegalArgumentException - если startIndex > endIndex

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