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

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.

Fontes