KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen