WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Java

String.join — Text mit einem Trennzeichen verbinden

String.join erstellt Text aus Elementen, die durch ein Trennzeichen getrennt werden. Die Methode akzeptiert ein Iterable oder Argumente mit variabler Anzahl.

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

Syntax

public static String join(CharSequence delimiter, Iterable<? extends CharSequence> elements)
public static String join(CharSequence delimiter, CharSequence... elements)

String.join ist eine statische Methode, die einen neuen String zurückgibt. Sie fügt delimiter zwischen den Elementen ein, nicht davor oder danach.

Die Überladung mit Iterable<? extends CharSequence> akzeptiert zum Beispiel eine List<String> und folgt der Iterationsreihenfolge. Die Variante CharSequence... akzeptiert einzelne Argumente oder ein Array. Elemente müssen Werte vom Typ CharSequence sein, keine beliebigen Objekte.

Ein null-Element ergibt den Text "null". Ist dagegen der Trennwert oder das gesamte Argument elements null, wird eine NullPointerException ausgelöst.

Beispiele

import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> parts = List.of("red", "green", "blue");
        System.out.println(String.join(" | ", parts));
        System.out.println(String.join("-", "A", null, "B"));
    }
}

Ergebnis

red | green | blue
A-null-B

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