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

CKTIS / Java

StringBuilder.append — acrescentar texto

StringBuilder.append(String) acrescenta texto ao final de um builder existente e devolve esse mesmo objeto, permitindo encadear chamadas.

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

Sintaxe

public StringBuilder append(String str)

StringBuilder.append tem várias sobrecargas. A sobrecarga append(String str) acrescenta os caracteres de str pela ordem em que aparecem. Modifica o builder existente e devolve uma referência para esse mesmo objeto, permitindo encadear chamadas.

Se um argumento String tiver o valor null, são acrescentados os quatro caracteres "null". No exemplo, missing tem explicitamente o tipo String, selecionando a sobrecarga adequada. toString() devolve o resultado como String.

StringBuilder não é seguro para partilhar entre threads sem sincronização.

Exemplos

public class Main {
    public static void main(String[] args) {
        StringBuilder builder = new StringBuilder("Hello");
        String missing = null;
        builder.append(", ").append("Java").append("! ").append(missing);
        System.out.println(builder.toString());
    }
}

Resultado

Hello, Java! null

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