Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / Java

String.intern() en Java: cadenas canónicas, identidad y contenido

Aprende por qué dos cadenas con el mismo contenido pueden ser objetos distintos, cómo `intern()` devuelve la cadena canónica y qué cuenta `length()`.

Versión: Java SE 21

Sintaxis

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) llama al constructor String(String) de java.lang.String y crea un objeto distinto con el mismo contenido que s. Como las cadenas son inmutables, por lo general basta con asignar la referencia existente. Pasar null a esta sobrecarga lanza NullPointerException.

length() cuenta unidades de código UTF-16 (valores char), no puntos de código ni caracteres percibidos por el usuario. Dos cadenas de la misma longitud pueden tener contenidos distintos. Si s no es null, s.equals(t) devuelve true solo si t es un String con la misma secuencia exacta de unidades de código, distinguiendo mayúsculas de minúsculas. Si el argumento es null, devuelve false. Invocar un método de instancia sobre una referencia null lanza NullPointerException. En cambio, == compara referencias: da true si apuntan al mismo objeto o si ambas son null.

String.intern() es un método de instancia. Si el pool ya contiene una cadena igual según equals(Object), devuelve su referencia. Si no, añade al pool el objeto sobre el que se invocó y devuelve su referencia. Los literales de cadena y los valores de expresiones constantes de tipo String se internan automáticamente. Si ni s ni t son null, s.intern() == t.intern() da true exactamente cuando s.equals(t) da true. Usa la referencia devuelta: la llamada no cambia la cadena ni la referencia guardada en la variable.

Para comparar contenido, usa normalmente equals(Object), no ==. El internado no garantiza un ahorro de memoria ni una mejora de velocidad. No des por supuesta una duración concreta para las entradas del pool; mide el coste y el beneficio con tu carga de trabajo real antes de usarlo como optimización.

Ejemplos

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` cuenta una unidad de código UTF-16 para `A` y dos para el emoji. La copia tiene el mismo contenido, pero una identidad distinta. `intern()` devuelve la referencia del literal existente y `copy` sigue apuntando al objeto nuevo.

Lecciones relacionadas

  • Java · Lección 49 · Avanzado · Versión: 2

Fuentes