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

CKTIS / Java

String.concat(String)

En Java SE 21, `String.concat(String)` ajoute une chaîne à la suite d’une autre. Si l’argument est vide, la méthode renvoie l’objet d’origine.

Version : Java SE 21

Syntaxe

public String concat(String str)

String.concat(String) ajoute son argument à la fin de la chaîne réceptrice. Les objets String sont immuables. Si l’argument est vide, la méthode renvoie le même objet. Un argument null provoque une NullPointerException. À l’inverse, la concaténation de chaînes avec + convertit une référence null en texte "null".

L’exemple appelle concat via un handle de méthode. Pour rechercher concat, MethodType.methodType(String.class, String.class) indique d’abord le type de retour, puis le type du paramètre déclaré. Le handle lui-même reçoit d’abord le récepteur, puis la chaîne à ajouter. La conversion explicite en String fixe le type de retour au site d’appel pour qu’il corresponde à celui qu’exige invokeExact.

Exemples

import java.lang.invoke.MethodHandle;
import java.lang.invoke.MethodHandles;
import java.lang.invoke.MethodType;

public class Main {
    public static void main(String[] args) throws Throwable {
        MethodHandles.Lookup lookup = MethodHandles.lookup();
        MethodHandle concat = lookup.findVirtual(
                String.class, "concat", MethodType.methodType(String.class, String.class));
        MethodHandle length = lookup.findVirtual(
                String.class, "length", MethodType.methodType(int.class));

        String prefix = "A";
        String joined = (String) concat.invokeExact(prefix, "\uD83D\uDE00");
        int units = (int) length.invokeExact(joined);
        String unchanged = (String) concat.invokeExact(prefix, "");

        System.out.println(units);
        System.out.println(unchanged == prefix);
    }
}

Résultat

3
true

L’exemple ajoute l’emoji U+1F600 à `A`. L’appel à `length()` sert seulement à mesurer le résultat : `A` occupe une unité de code UTF-16 et l’emoji en occupe deux. La première ligne affiche donc `3`. La seconde affiche `true` : après l’ajout d’une chaîne vide, `==` confirme que `concat` a renvoyé le même objet.

Leçons associées

  • Java · Leçon 56 · Avancé · Version : 2

Sources