8.4. A classe StringBuilder

Consulte a documentação da classe StringBuilder do pacote java.lang em https://docs.oracle.com/javase/9/docs/api/java/lang/StringBuilder.html.

Uma instância desta classe é um objeto capaz de construir e manipular uma String.

As instruções seguintes exemplificam a utilização de um objeto do tipo StringBuilder.

​x
StringBuilder texto = new StringBuilder("ola"); 
System.out.println(texto.toString());
​
texto.append(", bom dia");
System.out.println(texto.toString()); 
​
texto.insert(3, " Maria");
System.out.println(texto.toString());
​
texto.setCharAt(0, 'O');
System.out.println(texto.toString());
​
texto.delete(3,9);
System.out.println(texto.toString());

A invocação do método toString() sobre o StringBuilder permite obter a String que lhe está subjacente.

Tente perceber o que retorna cada método invocado sabendo que a execução destas instruções escreve no ecrã:

xxxxxxxxxx
ola
ola, bom dia
ola Maria, bom dia
Ola Maria, bom dia
Ola, bom dia 

Concluindo, as seguintes instruções ilustram uma forma mais correta (porque mais eficiente no uso da memória) de obter o efeito do exemplo da secção anterior:

xxxxxxxxxx
StringBuilder sb = new StringBuilder("Blah");
for (int i = 1; i <= 10; i++) { 
    sb.append(" blah"); 
} 
System.out.println(sb.toString());

Aqui criamos um único objeto do tipo StringBuilder e modificamos o seu estado passo a passo.

No final invocamos o método toString sobre o StringBuilder para obter a String que lhe está subjacente e imprimimo-la no ecrã.

Anterior: 8.3. Construindo uma String passo a passo

Seguinte: 8.5. Input e Output em Java