Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Java

StringJoiner — łączenie elementów z separatorem

StringJoiner buduje tekst z separatorem, prefiksem i sufiksem. merge zachowuje wewnętrzny separator dołączanej zawartości.

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

Składnia

new StringJoiner(delimiter, prefix, suffix)
joiner.add(element)
joiner.merge(other)
joiner.toString()

java.util.StringJoiner łączy elementy. Konstruktor StringJoiner(CharSequence,CharSequence,CharSequence) przyjmuje kolejno separator, prefiks i sufiks; kopiuje je, a dla null zgłasza NullPointerException.

add(CharSequence) kopiuje element; null staje się tekstem "null". add i merge zwracają obiekt docelowy, umożliwiając łańcuchy wywołań.

merge(StringJoiner) dodaje niepustą zawartość jako jeden element, pomijając jej prefiks i sufiks, ale zachowując wewnętrzny separator. Pusty argument niczego nie zmienia; null powoduje NullPointerException.

toString() zwraca tekst z obramowaniem. Bez elementów zwraca prefix + suffix, chyba że ustawiono setEmptyValue. add("") sprawia, że obiekt przestaje być pusty.

Identyfikatory objęte tym wpisem: StringJoiner.add, StringJoiner.merge, StringJoiner.toString.

Przykłady

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

Wynik

[]
[A, B/C]

Wyświetlony kod i zadeklarowany wynik zweryfikowano w odizolowanym środowisku metodą zapisaną w dowodzie weryfikacji tej dokładnej wersji.

Źródła