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.