WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

StringJoiner — Elemente mit Trennzeichen verbinden

StringJoiner erstellt Text mit Trennzeichen, Präfix und Suffix. merge erhält das interne Trennzeichen des hinzugefügten Inhalts.

Version: Java SE 21; repository runtime, production runtime not attested

Syntax

new StringJoiner(delimiter, prefix, suffix)
joiner.add(element)
joiner.merge(other)
joiner.toString()

java.util.StringJoiner verbindet Elemente. StringJoiner(CharSequence,CharSequence,CharSequence) erwartet der Reihe nach Trennzeichen, Präfix und Suffix; diese werden kopiert, und bei null wird eine NullPointerException ausgelöst.

add(CharSequence) kopiert ein Element; null wird zum Text "null". Sowohl add als auch merge geben das empfangende Objekt zurück und ermöglichen so Aufrufketten.

merge(StringJoiner) fügt nicht leeren Inhalt als ein Element hinzu. Dabei werden Präfix und Suffix des übergebenen Joiners weggelassen, sein internes Trennzeichen bleibt jedoch erhalten. Ein leeres Argument ändert nichts; bei null wird eine NullPointerException ausgelöst.

toString() gibt den umrahmten Text zurück. Ohne Elemente liefert die Methode prefix + suffix, sofern dies nicht durch setEmptyValue überschrieben wurde. Mit add("") ist der Joiner nicht mehr leer.

In diesem Eintrag behandelte Referenzbezeichner: StringJoiner.add, StringJoiner.merge, StringJoiner.toString.

Beispiele

import java.util.StringJoiner;

public class Main {
    public static void main(String[] args) {
        StringJoiner result = new StringJoiner(", ", "[", "]");
        System.out.println(result.toString());
        result.add("A");
        StringJoiner other = new StringJoiner("/", "(", ")");
        other.add("B").add("C");
        result.merge(other);
        System.out.println(result.toString());
    }
}

Ergebnis

[]
[A, B/C]

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