Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

StringJoiner — unir elementos con un delimitador

StringJoiner construye texto con un delimitador, un prefijo y un sufijo. merge conserva el delimitador interno del contenido añadido.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

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

java.util.StringJoiner une elementos. StringJoiner(CharSequence,CharSequence,CharSequence) recibe, en este orden, el delimitador, el prefijo y el sufijo; los copia y lanza NullPointerException si alguno es null.

add(CharSequence) copia un elemento; null se convierte en el texto "null". Tanto add como merge devuelven el objeto receptor, lo que permite encadenar llamadas.

merge(StringJoiner) añade el contenido no vacío como un solo elemento: omite su prefijo y sufijo, pero conserva su delimitador interno. Un argumento vacío no cambia nada; null provoca NullPointerException.

toString() devuelve el texto delimitado. Si no hay elementos, devuelve prefix + suffix, salvo que setEmptyValue establezca otro valor. add("") hace que el joiner deje de estar vacío.

Identificadores de referencia incluidos en esta entrada: StringJoiner.add, StringJoiner.merge, StringJoiner.toString.

Ejemplos

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]

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes