WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

StringBuilder.toString — Text als String erhalten

StringBuilder.toString() gibt einen String mit dem aktuellen Inhalt des Builders zurück. Spätere Änderungen am Builder verändern den zurückgegebenen Text nicht.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

public String toString()
String result = builder.toString();

StringBuilder.toString() ist eine Instanzmethode ohne Argumente, die einen String mit der aktuellen Zeichenfolge zurückgibt. Rufe sie auf einem Objekt auf, zum Beispiel mit builder.toString(), nicht auf der Klasse.

Die Methode leert oder verändert den Builder nicht. Die Dokumentation für Java SE 21 beschreibt, dass ein neues String-Objekt erstellt wird; nachfolgende Änderungen am StringBuilder wirken sich nicht auf dessen Inhalt aus.

Im Beispiel enthält snapshot weiterhin Java 21, nachdem ! an den Builder angehängt wurde. Der nächste Aufruf von builder.toString() gibt Java 21! zurück. Der Methodenaufruf allein gibt keinen Text aus — das übernimmt System.out.println.

Beispiele

public class Main {
    public static void main(String[] args) {
        StringBuilder builder = new StringBuilder("Java");
        builder.append(" 21");
        String snapshot = builder.toString();
        builder.append("!");

        System.out.println(snapshot);
        System.out.println(builder.toString());
    }
}

Ergebnis

Java 21
Java 21!

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen