Функция clear

Функция clear очищает содержимое объекта StringBuilder, устанавливая его длину в ноль. При этом сам объект StringBuilder остается неизменным, но становится пустым. Это более читаемая альтернатива установке длины в ноль через setLength(0).

Синтаксис

kotlinfun StringBuilder.clear(): StringBuilder

Пример

Создадим StringBuilder с содержимым и очистим его с помощью clear:

kotlinval sb = StringBuilder("Hello, World!")
println("Before clear: '$sb', length: ${sb.length}")

sb.clear()
println("After clear: '$sb', length: ${sb.length}")

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

kotlinBefore clear: 'Hello, World!', length: 13
After clear: '', length: 0

Пример

Функция clear возвращает тот же объект StringBuilder, что позволяет использовать цепочку вызовов:

kotlinval result = StringBuilder("Old content")
  .clear()
  .append("New content")
  .toString()

println(result)

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

kotlinString "New content"

Пример

Сравнение clear() и setLength(0):

kotlinval sb1 = StringBuilder("Text to clear")
val sb2 = StringBuilder("Text to set length")

sb1.clear()
sb2.setLength(0)

println("clear(): '$sb1'")
println("setLength(0): '$sb2'")
println("Are both empty? ${sb1.isEmpty() && sb2.isEmpty()}")

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

kotlinclear(): ''
setLength(0): ''
Are both empty? true

Примечания

Функция clear является extension-функцией и доступна только в Kotlin. В отличие от setLength(0), который является методом из Java, clear предоставляет более идиоматический способ очистки для Kotlin-разработчиков.

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