Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

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