Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

StringBuilder.toString — pobranie tekstu jako String

StringBuilder.toString() zwraca String z bieżącą zawartością bufora. Późniejsze zmiany bufora nie zmieniają otrzymanego tekstu.

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

Składnia

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

StringBuilder.toString() to metoda instancji bez argumentów, zwracająca String z aktualną sekwencją znaków. Wywołuj ją na obiekcie, na przykład builder.toString(), a nie na klasie.

Metoda nie opróżnia ani nie modyfikuje bufora. Dokumentacja Java SE 21 określa utworzenie nowego obiektu String; późniejsze zmiany StringBuilder nie wpływają na jego zawartość.

W przykładzie snapshot zachowuje Java 21, mimo że do bufora dopisano !. Kolejne wywołanie builder.toString() zwraca już Java 21!. Samo wywołanie metody nie wypisuje tekstu — robi to System.out.println.

Przykłady

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());
    }
}

Wynik

Java 21
Java 21!

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła