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

CKTIS / Java

String.equals — comparar el contenido de cadenas

String.equals compara el contenido de las cadenas distinguiendo entre mayúsculas y minúsculas. El operador == compara la identidad de los objetos, no su contenido.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

public boolean equals(Object anObject)

String.equals tiene la firma public boolean equals(Object anObject). Devuelve true únicamente si el argumento es una referencia no nula a un objeto String con la misma secuencia de caracteres. Distingue entre mayúsculas y minúsculas: "Java".equals("java") devuelve false.

En el caso de las referencias, == comprueba si apuntan al mismo objeto. En el ejemplo, new String("Java") crea un objeto distinto, por lo que a.equals(b) devuelve true, mientras que a == b devuelve false.

Un argumento de otro tipo, como StringBuilder, da como resultado false aunque el contenido coincida. a.equals(null) devuelve false si a no es null. Llamar a un método mediante una referencia null provoca una NullPointerException; escribir "Java".equals(missing) evita este problema.

Alcance de la documentación: Java SE 21. No se han certificado el entorno de ejecución del repositorio ni el de producción.

Ejemplos

public class Main {
    public static void main(String[] args) {
        String a = "Java";
        String b = new String("Java");
        String missing = null;

        System.out.println(a.equals(b));
        System.out.println(a == b);
        System.out.println(a.equals("java"));
        System.out.println(a.equals(new StringBuilder("Java")));
        System.out.println(a.equals(missing));
        System.out.println("Java".equals(missing));
    }
}

Resultado

true
false
false
false
false
false

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes