Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

String.equals — confrontare il contenuto delle stringhe

String.equals confronta il contenuto delle stringhe distinguendo tra maiuscole e minuscole. L’operatore == confronta l’identità degli oggetti, non il loro contenuto.

Versione: Java SE 21; repository runtime, production runtime not attested

Sintassi

public boolean equals(Object anObject)

String.equals ha la firma public boolean equals(Object anObject). Restituisce true solo se l’argomento è un riferimento non nullo a un oggetto String con la stessa identica sequenza di caratteri. Distingue tra maiuscole e minuscole: "Java".equals("java") restituisce false.

Per i riferimenti, == verifica se indicano lo stesso oggetto. Nell’esempio, new String("Java") crea un oggetto separato, quindi a.equals(b) restituisce true, mentre a == b restituisce false.

Un argomento di un altro tipo, ad esempio StringBuilder, produce false anche quando il contenuto è identico. a.equals(null) restituisce false se a non è null. Chiamare un metodo su un riferimento null genera una NullPointerException; scrivere "Java".equals(missing) evita questo problema.

Ambito della documentazione: Java SE 21. L’ambiente di esecuzione del repository e quello di produzione non sono stati attestati.

Esempi

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

Risultato

true
false
false
false
false
false

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti