Функция appendLine
Функция appendLine добавляет строковое представление
переданного объекта в конец StringBuilder и автоматически
добавляет символ перевода строки "\n". Это удобно для
построчного формирования текста.
Синтаксис
fun appendLine(value: Any?): StringBuilder
fun appendLine(): StringBuilder
Пример
Добавим несколько строк в билдер:
val builder = StringBuilder()
builder.appendLine("First line")
builder.appendLine("Second line")
builder.appendLine(123)
println(builder.toString())
Результат выполнения кода:
String "First line\nSecond line\n123\n"
Пример
Использование функции без параметров добавляет только перевод строки:
val builder = StringBuilder()
builder.append("Text without newline")
builder.appendLine()
builder.append("Text on new line")
println(builder.toString())
Результат выполнения кода:
String "Text without newline\nText on new line"
Пример
Добавление null значения:
val builder = StringBuilder()
builder.appendLine("Start")
builder.appendLine(null)
builder.appendLine("End")
println(builder.toString())
Результат выполнения кода:
String "Start\nnull\nEnd\n"
Пример
Функция возвращает сам StringBuilder, что позволяет
использовать цепочку вызовов:
val text = StringBuilder()
.appendLine("Line 1")
.appendLine("Line 2")
.appendLine("Line 3")
.toString()
println(text)
Результат выполнения кода:
String "Line 1\nLine 2\nLine 3\n"
