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.