CKTIS / Java
StringBuilder.append — Text anhängen
StringBuilder.append(String) hängt Text an das Ende eines vorhandenen Builders an und gibt dasselbe Objekt zurück, sodass sich Aufrufe verketten lassen.
Version: Java SE 21; repository runtime, production runtime not attested
Syntax
public StringBuilder append(String str)StringBuilder.append hat mehrere Überladungen. Die Überladung append(String str) hängt die Zeichen von str in ihrer Reihenfolge an. Sie verändert den vorhandenen Builder und gibt eine Referenz auf dasselbe Objekt zurück, sodass sich Aufrufe verketten lassen.
Bei einem String-Argument mit dem Wert null werden die vier Zeichen "null" angehängt. Im Beispiel ist missing ausdrücklich als String deklariert, wodurch die passende Überladung ausgewählt wird. toString() gibt das Ergebnis als String zurück.
StringBuilder kann ohne Synchronisierung nicht sicher zwischen Threads gemeinsam verwendet werden.
Beispiele
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());
}
}Ergebnis
Hello, Java! null
Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.