Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

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.

Fontes