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
- 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