Функция setLength

Функция setLength устанавливает новую длину для объекта StringBuilder. Если новая длина меньше текущей, строка усекается. Если новая длина больше текущей, строка дополняется нулевыми символами ('\u0000'). Принимает один параметр типа Int - новую длину строки.

Синтаксис

fun setLength(newLength: Int): Unit

Пример

Установим длину строки 5 для StringBuilder, содержащего строку "Hello, World!":

val sb = StringBuilder("Hello, World!")
sb.setLength(5)
println(sb.toString())

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

String "Hello"

Пример

Установим длину строки 10 для StringBuilder, содержащего строку "Hello":

val sb = StringBuilder("Hello")
sb.setLength(10)
val result = sb.toString()
println(result)

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

String "Hello "

Пример

Установим нулевую длину для очистки содержимого StringBuilder:

val sb = StringBuilder("Some text")
sb.setLength(0)
println("Length: " + sb.length)
println("Content: '" + sb.toString() + "'")

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

Length: 0
Content: ''

Пример

Проверим обработку отрицательной длины:

val sb = StringBuilder("Test")

try {
	sb.setLength(-1)
} catch (e: IndexOutOfBoundsException) {
	println("Error: " + e.message)
}

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

Error: -1

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

функцию length,
которая возвращает текущую длину StringBuilder
функцию clear,
которая очищает содержимое StringBuilder
функцию delete,
которая удаляет часть символов из строки
функцию trimToSize,
которая уменьшает емкость до текущей длины