Znalostní bázeCentrum zkoušek
CSČeština
Vybrat jazyk13

CKTIS / Java

String.join — spojování textu pomocí oddělovače

String.join vytváří text z prvků oddělených oddělovačem. Přijímá Iterable nebo proměnný počet argumentů.

Verze: Java SE 21; repository runtime, production runtime not attested

Syntaxe

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

String.join je statická metoda, která vrací nový String. Vkládá delimiter mezi prvky, nikoli před ně nebo za ně.

Přetížení Iterable<? extends CharSequence> přijímá například List<String> a zachovává pořadí iterace. Varianta CharSequence... přijímá samostatné argumenty nebo pole. Prvky musí být hodnoty typu CharSequence, nikoli libovolné objekty.

Prvek null vytvoří text "null". Pokud je však null oddělovač nebo celý argument elements, dojde k výjimce NullPointerException.

Příklady

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"));
    }
}

Výsledek

red | green | blue
A-null-B

Zobrazený kód a uvedený výsledek byly ověřeny v izolovaném prostředí metodou zaznamenanou v dokladu o ověření této přesné verze.

Zdroje