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
- String (Java SE 21 & JDK 21) — concat(String)
- String (Java SE 21 & JDK 21) — length()
- MethodHandles.Lookup (Java SE 21 & JDK 21) — findVirtual
- MethodType (Java SE 21 & JDK 21)
- MethodHandle (Java SE 21 & JDK 21) — invokeExact
- Java Language Specification, Java SE 21 — §15.8.2 Class Literals
- Java Language Specification, Java SE 21 — §15.18.1 String Concatenation Operator +
- Java Language Specification, Java SE 21 — §5.1.11 String Conversion