Справочник Java

StringBuilder.append()

Добавляет значение в конец StringBuilder.

Доступно с: Java 5

Синтаксис

public StringBuilder append(Object obj)

Параметры

Параметр	Тип	Описание
obj	Object, String, int, char, double…	Что добавить: строку, число, символ, boolean или любой объект (через его toString()).

Возвращаемое значение

StringBuilderТот же StringBuilder — поэтому вызовы можно ставить цепочкой.

Примеры

Цепочка вызовов:

void main() {
    var sb = new StringBuilder();
    sb.append("Total: ").append(3).append(" items, ").append(4.5).append('$');
    IO.println(sb);
}

Результат:

Total: 3 items, 4.5$

Список через запятую без лишней запятой в конце:

void main() {
    String[] names = {"Anna", "Oleg", "Maria"};
    var sb = new StringBuilder();
    for (String name : names) {
        if (!sb.isEmpty()) {
            sb.append(", ");
        }
        sb.append(name);
    }
    IO.println(sb);
}

Результат:

Anna, Oleg, Maria

Примечания

append(char) добавляет символ, а append(int) — число: sb.append('a' + 1) добавит 98, потому что 'a' + 1 — это int. Метод isEmpty() у StringBuilder появился в Java 15.

См. также

StringBuilder — Изменяемая строка: удобна, когда текст собирается по частям, особенно в цикле.
StringBuilder.insert() — Вставляет значение в указанную позицию StringBuilder.
StringBuilder.toString() — Возвращает содержимое StringBuilder как обычную строку String.

Вопросы и ответы по теме

В учебнике

StringBuilder — StringBuilder в Java: изменяемая строка, append, insert, reverse, deleteCharAt, цепочки вызовов и сборка строки в цикле.

Спасибо, что читаете!