CKTIS / Java
StringBuilder — um buffer de texto modificável
StringBuilder permite construir e modificar texto gradualmente. Aprende a diferença entre comprimento e capacidade e o que acontece quando setLength trunca ou aumenta a sequência.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new StringBuilder();
new StringBuilder(8);
int length();
int capacity();
void setLength(int newLength);java.lang.StringBuilder é uma sequência de caracteres modificável. append acrescenta conteúdo e toString() cria o String resultante. A classe não garante sincronização; não partilhes uma instância modificável entre threads sem a sincronização adequada.
StringBuilder() cria um buffer vazio com capacidade 16. StringBuilder(int) cria um buffer vazio com a capacidade especificada; um valor negativo provoca NegativeArraySizeException. A capacidade inicial não é o comprimento do texto.
StringBuilder.length() devolve o número de unidades char UTF-16 no conteúdo, que não corresponde necessariamente ao número de caracteres visíveis para o utilizador. StringBuilder.capacity() indica o espaço para essas unidades, incluindo as posições já ocupadas. A capacidade aumenta automaticamente quando é necessário mais espaço.
StringBuilder.setLength(int) devolve void: um comprimento inferior trunca o final, enquanto um comprimento superior acrescenta caracteres com valor zero ('\u0000'), não espaços. Um comprimento negativo provoca IndexOutOfBoundsException. setLength(0) remove todo o conteúdo lógico; não o consideres uma eliminação segura de dados da memória.
Exemplos
public class Main {
public static void main(String[] args) {
StringBuilder defaults = new StringBuilder();
System.out.println(defaults.length() + ":" + defaults.capacity());
StringBuilder text = new StringBuilder(8);
text.append("Java");
System.out.println(text.length() + ":" + text.capacity());
text.setLength(2);
System.out.println(text.toString());
text.setLength(4);
System.out.println(text.length() + ":" + (int) text.charAt(2));
text.setLength(0);
System.out.println(text.length());
}
}Resultado
0:16 4:8 Ja 4:0 0
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.