CKTIS / Java
StringJoiner — juntar elementos com um delimitador
StringJoiner constrói texto com um delimitador, um prefixo e um sufixo. merge preserva o delimitador interno do conteúdo adicionado.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
new StringJoiner(delimiter, prefix, suffix)
joiner.add(element)
joiner.merge(other)
joiner.toString()java.util.StringJoiner junta elementos. StringJoiner(CharSequence,CharSequence,CharSequence) recebe, por esta ordem, o delimitador, o prefixo e o sufixo; copia-os e lança NullPointerException se algum for null.
add(CharSequence) copia um elemento; null passa a ser o texto "null". Tanto add como merge devolvem o objeto recetor, permitindo encadear chamadas.
merge(StringJoiner) acrescenta o conteúdo não vazio como um único elemento, removendo o respetivo prefixo e sufixo, mas preservando o delimitador interno. Um argumento vazio não altera nada; null provoca NullPointerException.
toString() devolve o texto delimitado. Sem elementos, devolve prefix + suffix, exceto se setEmptyValue definir outro valor. add("") faz com que o joiner deixe de estar vazio.
Identificadores de referência abrangidos por esta entrada: StringJoiner.add, StringJoiner.merge, StringJoiner.toString.
Exemplos
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());
}
}Resultado
[] [A, B/C]
O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.