Функция setLength

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

Синтаксис

kotlinfun setLength(newLength: Int): Unit

Пример

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

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

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

kotlinString "Hello"

Пример

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

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

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

kotlinString "Hello     "

Пример

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

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

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

kotlinLength: 0
Content: ''

Пример

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

kotlinval sb = StringBuilder("Test")

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

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

kotlinError: -1

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

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