WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

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.

Quellen