Справочник Java

StringBuilder.toString()

Возвращает содержимое StringBuilder как обычную строку String.

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

Синтаксис

public String toString()

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

StringНовая строка с текущим содержимым.

Примеры

Результат — независимая копия:

void main() {
    var sb = new StringBuilder("draft");
    String saved = sb.toString();
    sb.append(" v2");
    IO.println(saved);
    IO.println(sb.toString());
}

Результат:

draft
draft v2

Для сравнения содержимого нужен toString():

void main() {
    var sb = new StringBuilder("abc");
    IO.println(sb.equals("abc"));
    IO.println(sb.toString().equals("abc"));
}

Результат:

false
true

Примечания

IO.println(sb) и конкатенация "x" + sb вызывают toString() сами. Явно его вызывают, когда нужен именно String: вернуть из метода, сравнить, положить в коллекцию строк.

См. также

StringBuilder — Изменяемая строка: удобна, когда текст собирается по частям, особенно в цикле.
StringBuilder.append() — Добавляет значение в конец StringBuilder.

В учебнике

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

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