KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Java

StringJoiner — elementen samenvoegen met een scheidingsteken

StringJoiner bouwt tekst op met een scheidingsteken, een prefix en een suffix. merge behoudt het interne scheidingsteken van de toegevoegde inhoud.

Versie: 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 voegt elementen samen. StringJoiner(CharSequence,CharSequence,CharSequence) verwacht achtereenvolgens het scheidingsteken, de prefix en de suffix; deze worden gekopieerd. Bij null volgt een NullPointerException.

add(CharSequence) kopieert een element; null wordt de tekst "null". Zowel add als merge retourneert het ontvangende object, zodat aanroepen kunnen worden gekoppeld.

merge(StringJoiner) voegt niet-lege inhoud toe als één element. De prefix en suffix daarvan worden weggelaten, maar het interne scheidingsteken blijft behouden. Een leeg argument verandert niets; null veroorzaakt een NullPointerException.

toString() retourneert de omkaderde tekst. Zonder elementen retourneert deze methode prefix + suffix, tenzij setEmptyValue dit overschrijft. Met add("") is de joiner niet langer leeg.

Referentie-identificatoren die in dit item worden behandeld: StringJoiner.add, StringJoiner.merge, StringJoiner.toString.

Voorbeelden

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());
    }
}

Resultaat

[]
[A, B/C]

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