CKTIS / Java
String.intern() in Java: stringhe canoniche, identità e contenuto
Scopri perché due stringhe con lo stesso contenuto possono essere oggetti distinti, come `intern()` restituisce quella canonica e che cosa conta `length()`.
Versione: Java SE 21
Sintassi
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();In Java SE 21, new String(s) chiama il costruttore String(String) di java.lang.String e crea un oggetto distinto con lo stesso contenuto di s. Poiché le stringhe sono immutabili, in genere basta assegnare il riferimento esistente. Passare null a questo overload genera una NullPointerException.
length() conta le unità di codice UTF-16 (valori char), non i punti di codice né i caratteri percepiti dall’utente. Una stessa lunghezza non implica lo stesso contenuto. Se s non è null, s.equals(t) restituisce true solo se t è una String con la stessa identica sequenza di unità di codice, distinguendo maiuscole e minuscole. Con null come argomento restituisce false. Chiamare un metodo di istanza su un riferimento null genera una NullPointerException. L’operatore == confronta invece i riferimenti: vale true se indicano lo stesso oggetto o se sono entrambi null.
String.intern() è un metodo di istanza. Se nel pool è già presente una stringa uguale secondo equals(Object), il metodo ne restituisce il riferimento. Altrimenti inserisce nel pool l’oggetto su cui è stato chiamato e ne restituisce il riferimento. I letterali stringa e i valori delle espressioni costanti di tipo String vengono internati automaticamente. Se né s né t sono null, s.intern() == t.intern() vale true esattamente quando s.equals(t) vale true. Usa il riferimento restituito: la chiamata non cambia né la stringa né il riferimento memorizzato nella variabile.
Per confrontare il contenuto usa normalmente equals(Object), non ==. L’interning non garantisce un risparmio di memoria né un aumento di velocità. Non dare per scontata una durata specifica per le voci del pool; misura costi e benefici sul carico di lavoro reale prima di usare questa tecnica come ottimizzazione.
Esempi
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));
}
}
Risultato
length: 3 same contents: true same object: false canonical is literal: true copy is canonical: false
`length: 3` conta un’unità di codice UTF-16 per `A` e due per l’emoji. La copia ha lo stesso contenuto, ma un’identità diversa. `intern()` restituisce il riferimento del letterale già presente, mentre `copy` continua a riferirsi al nuovo oggetto.
Lezioni correlate
- Java · Lezione 49 · Avanzato · Versione: 2
Fonti
- 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