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.