Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

StringBuilder.toString — obter texto como String

StringBuilder.toString() devolve um String com o conteúdo atual do builder. Alterações posteriores no builder não alteram o texto devolvido.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

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

StringBuilder.toString() é um método de instância sem argumentos que devolve um String com a sequência de caracteres atual. Chama-o num objeto, por exemplo builder.toString(), e não na classe.

O método não limpa nem modifica o builder. A documentação de Java SE 21 especifica a criação de um novo objeto String; alterações posteriores no StringBuilder não afetam o seu conteúdo.

No exemplo, snapshot mantém Java 21 depois de ! ser acrescentado ao builder. A chamada seguinte a builder.toString() devolve Java 21!. A chamada do método, por si só, não imprime texto — isso é feito por System.out.println.

Exemplos

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

Resultado

Java 21
Java 21!

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes