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

CKTIS / Java

String.join — unir texto com um delimitador

String.join cria texto a partir de elementos separados por um delimitador. Aceita um Iterable ou argumentos de número variável.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public static String join(CharSequence delimiter, Iterable<? extends CharSequence> elements)
public static String join(CharSequence delimiter, CharSequence... elements)

String.join é um método estático que devolve um novo String. Insere delimiter entre os elementos, não antes nem depois deles.

A sobrecarga Iterable<? extends CharSequence> aceita, por exemplo, uma List<String> e segue a ordem de iteração. A variante CharSequence... aceita argumentos separados ou um array. Os elementos têm de ser valores do tipo CharSequence, não objetos arbitrários.

Um elemento null produz o texto "null". No entanto, se o delimitador ou o argumento elements completo for null, é lançada uma NullPointerException.

Exemplos

import java.util.List;

public class Main {
    public static void main(String[] args) {
        List<String> parts = List.of("red", "green", "blue");
        System.out.println(String.join(" | ", parts));
        System.out.println(String.join("-", "A", null, "B"));
    }
}

Resultado

red | green | blue
A-null-B

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