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.