Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / Java

StringJoiner — joindre des éléments avec un délimiteur

StringJoiner construit du texte avec un délimiteur, un préfixe et un suffixe. merge préserve le délimiteur interne du contenu ajouté.

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

Syntaxe

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

java.util.StringJoiner permet de joindre des éléments. StringJoiner(CharSequence,CharSequence,CharSequence) prend, dans l’ordre, le délimiteur, le préfixe puis le suffixe ; il les copie et déclenche une NullPointerException en cas de null.

add(CharSequence) copie un élément ; null devient le texte "null". add et merge renvoient tous deux l’objet destinataire, ce qui permet d’enchaîner les appels.

merge(StringJoiner) ajoute le contenu non vide comme un seul élément, en supprimant son préfixe et son suffixe, mais en préservant son délimiteur interne. Un argument vide ne change rien ; null provoque une NullPointerException.

toString() renvoie le texte encadré. En l’absence d’éléments, la méthode renvoie prefix + suffix, sauf si setEmptyValue remplace cette valeur. add("") rend le joiner non vide.

Identifiants de référence couverts par cette entrée : StringJoiner.add, StringJoiner.merge, StringJoiner.toString.

Exemples

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

Résultat

[]
[A, B/C]

Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.

Sources