CKTIS / Java
String.join — tekst samenvoegen met een scheidingsteken
String.join maakt tekst van elementen die door een scheidingsteken van elkaar worden gescheiden. De methode accepteert een Iterable of variabele argumenten.
Versie: 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 is een statische methode die een nieuwe String teruggeeft. De methode plaatst delimiter tussen de elementen, niet ervoor of erna.
De overload Iterable<? extends CharSequence> accepteert bijvoorbeeld een List<String> en houdt de iteratievolgorde aan. De variant CharSequence... accepteert losse argumenten of een array. Elementen moeten waarden van het type CharSequence zijn, geen willekeurige objecten.
Een null-element levert de tekst "null" op. Als het scheidingsteken of het volledige argument elements echter null is, wordt een NullPointerException veroorzaakt.
Voorbeelden
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"));
}
}Resultaat
red | green | blue A-null-B
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.