CKTIS / Java
String.intern() en Java : chaînes canoniques, identité et contenu
Découvrez pourquoi deux chaînes de même contenu peuvent être des objets distincts, comment `intern()` renvoie la chaîne canonique et ce que compte `length()`.
Version : Java SE 21
Syntaxe
Java SE 21 — java.lang.String
Primary API signature:
public String intern()
Supporting API signatures:
public String(String original)
public int length()
public boolean equals(Object anObject)
Usage (s and t are non-null String references):
String copy = new String(s);
String canonical = copy.intern();
int units = copy.length();
boolean sameContent = s.equals(t);
boolean sameObject = s == t;
boolean sameCanonicalObject = s.intern() == t.intern();En Java SE 21, new String(s) appelle le constructeur String(String) de java.lang.String et crée un objet distinct qui a le même contenu que s. Les chaînes étant immuables, une affectation de la référence existante suffit généralement. Passer null à cette surcharge provoque une NullPointerException.
length() compte les unités de code UTF-16 (valeurs char), pas les points de code ni les caractères perçus par l’utilisateur. Une même longueur ne signifie pas un même contenu. Si s n’est pas null, s.equals(t) renvoie true uniquement si t est une String qui contient exactement la même suite d’unités de code, en tenant compte de la casse. Avec null en argument, le résultat est false. Appeler une méthode d’instance sur une référence null provoque une NullPointerException. L’opérateur == compare les références : il renvoie true si elles désignent le même objet ou si elles valent toutes deux null.
String.intern() est une méthode d’instance. Si le pool contient déjà une chaîne égale selon equals(Object), elle renvoie la référence de cette chaîne. Sinon, elle ajoute au pool l’objet sur lequel elle est appelée et renvoie sa référence. Les littéraux de chaîne et les valeurs des expressions constantes de type String sont internés automatiquement. Si s et t ne sont pas null, s.intern() == t.intern() vaut true exactement quand s.equals(t) vaut true. Utilisez la référence renvoyée : l’appel ne modifie ni la chaîne ni la référence enregistrée dans la variable.
Pour comparer le contenu, utilisez normalement equals(Object), pas ==. L’internement ne garantit ni économie de mémoire ni gain de vitesse. Ne supposez pas une durée de vie précise pour les entrées du pool ; mesurez les coûts et les gains sur une charge réelle avant d’en faire une optimisation.
Exemples
public class Main {
public static void main(String[] args) {
String literal = "A\uD83D\uDE00";
String copy = new String(literal);
System.out.println("length: " + copy.length());
System.out.println("same contents: " + copy.equals(literal));
System.out.println("same object: " + (copy == literal));
String canonical = copy.intern();
System.out.println("canonical is literal: " + (canonical == literal));
System.out.println("copy is canonical: " + (copy == canonical));
}
}
Résultat
length: 3 same contents: true same object: false canonical is literal: true copy is canonical: false
`length: 3` compte une unité de code UTF-16 pour `A` et deux pour l’emoji. La copie a le même contenu, mais une identité distincte. `intern()` renvoie la référence du littéral déjà présent, tandis que `copy` désigne toujours le nouvel objet.
Leçons associées
- Java · Leçon 49 · Avancé · Version : 2
Sources
- Java SE 21 API — String(String original)
- Java SE 21 API — String.intern()
- Java SE 21 API — String.length()
- Java SE 21 API — String.equals(Object)
- Java Language Specification, Java SE 21 — §3.10.5 String Literals
- Java Language Specification, Java SE 21 — §15.21.3 Reference Equality Operators == and !=
- JDK 21 — The java Command: Using Source-File Mode to Launch Single-File Source-Code Programs