Функция appendLine

Функция appendLine добавляет строковое представление переданного объекта в конец StringBuilder и автоматически добавляет символ перевода строки "\n". Это удобно для построчного формирования текста.

Синтаксис

kotlinfun appendLine(value: Any?): StringBuilder

kotlinfun appendLine(): StringBuilder

Пример

Добавим несколько строк в билдер:

kotlinval builder = StringBuilder()
builder.appendLine("First line")
builder.appendLine("Second line")
builder.appendLine(123)
println(builder.toString())

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

kotlinString "First line\nSecond line\n123\n"

Пример

Использование функции без параметров добавляет только перевод строки:

kotlinval builder = StringBuilder()
builder.append("Text without newline")
builder.appendLine()
builder.append("Text on new line")
println(builder.toString())

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

kotlinString "Text without newline\nText on new line"

Пример

Добавление null значения:

kotlinval builder = StringBuilder()
builder.appendLine("Start")
builder.appendLine(null)
builder.appendLine("End")
println(builder.toString())

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

kotlinString "Start\nnull\nEnd\n"

Пример

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

kotlinval text = StringBuilder()
  .appendLine("Line 1")
  .appendLine("Line 2")
  .appendLine("Line 3")
  .toString()
println(text)

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

kotlinString "Line 1\nLine 2\nLine 3\n"

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