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.