Функция toCharArray
Функция toCharArray преобразует содержимое
StringBuilder в массив символов CharArray.
Может использоваться для получения копии данных
в виде массива, для передачи в функции, работающие
с массивами символов, или для модификации символов
без изменения исходного StringBuilder.
Синтаксис
fun toCharArray(): CharArray
fun toCharArray(
destination: CharArray,
destinationOffset: Int = 0,
startIndex: Int = 0,
endIndex: Int = length
)
Пример
Преобразуем StringBuilder в массив символов:
val sb = StringBuilder("abcde")
val charArray: CharArray = sb.toCharArray()
println(charArray.contentToString())
Результат выполнения кода:
CharArray ['a', 'b', 'c', 'd', 'e']
Пример
Использование функции с параметрами для копирования
части StringBuilder в существующий массив:
val sb = StringBuilder("12345")
val destArray = CharArray(3)
sb.toCharArray(
destination = destArray,
startIndex = 1,
endIndex = 4
)
println(destArray.contentToString())
Результат выполнения кода:
CharArray ['2', '3', '4']
Пример
Копирование с указанием смещения в целевом массиве:
val sb = StringBuilder("abcde")
val destArray = CharArray(5) { '-' }
sb.toCharArray(
destination = destArray,
destinationOffset = 1,
startIndex = 0,
endIndex = 3
)
println(destArray.contentToString())
Результат выполнения кода:
CharArray ['-', 'a', 'b', 'c', '-']
Параметры
destination - массив символов, в который
будет скопировано содержимое StringBuilder.
destinationOffset - позиция в целевом массиве,
с которой начинается копирование (по умолчанию 0).
startIndex - начальный индекс в StringBuilder
(включительно, по умолчанию 0).
endIndex - конечный индекс в StringBuilder
(исключительно, по умолчанию length).
Исключения
Функция может выбрасывать исключения:
IndexOutOfBoundsException - если индексы выходят за границы
IllegalArgumentException - если startIndex > endIndex
