Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

String.intern() em Java: cadeias canónicas, identidade e conteúdo

Percebe por que razão duas cadeias com o mesmo conteúdo podem ser objetos diferentes, como `intern()` devolve a cadeia canónica e o que `length()` conta.

Versão: Java SE 21

Sintaxe

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();

Em Java SE 21, new String(s) chama o construtor String(String) de java.lang.String e cria um objeto distinto com o mesmo conteúdo que s. Como as cadeias são imutáveis, normalmente basta atribuir a referência existente. Passar null a esta sobrecarga lança uma NullPointerException.

length() conta unidades de código UTF-16 (valores char), não pontos de código nem caracteres percebidos pelo utilizador. O mesmo comprimento não implica o mesmo conteúdo. Se s não for null, s.equals(t) devolve true apenas se t for uma String com a mesma sequência exata de unidades de código, distinguindo maiúsculas de minúsculas. Com null como argumento, devolve false. Invocar um método de instância sobre uma referência null lança uma NullPointerException. Já == compara referências: dá true se ambas apontarem para o mesmo objeto ou se ambas forem null.

String.intern() é um método de instância. Se já existir no pool uma cadeia igual segundo equals(Object), o método devolve a referência dessa cadeia. Caso contrário, adiciona ao pool o objeto sobre o qual foi chamado e devolve a respetiva referência. Os literais de cadeia e os valores de expressões constantes do tipo String são internados automaticamente. Se nem s nem t forem null, s.intern() == t.intern() dá true exatamente quando s.equals(t) dá true. Usa a referência devolvida: a chamada não altera a cadeia nem a referência guardada na variável.

Para comparar conteúdo, usa normalmente equals(Object), não ==. O interning não garante poupança de memória nem ganhos de velocidade. Não partas do princípio de que as entradas no pool têm um tempo de vida específico; mede os custos e os benefícios com a tua carga de trabalho real antes de o usares como otimização.

Exemplos

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));
    }
}

Resultado

length: 3
same contents: true
same object: false
canonical is literal: true
copy is canonical: false

`length: 3` conta uma unidade de código UTF-16 para `A` e duas para o emoji. A cópia tem o mesmo conteúdo, mas outra identidade. `intern()` devolve a referência do literal que já existe, enquanto `copy` continua a apontar para o novo objeto.

Lições relacionadas

  • Java · Lição 49 · Avançado · Versão: 2

Fontes