Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Java

String.equalsIgnoreCase — confronto senza distinzione tra maiuscole e minuscole

String.equalsIgnoreCase confronta le stringhe senza distinguere tra maiuscole e minuscole, indipendentemente dalle impostazioni locali. Restituisce un boolean.

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

Sintassi

public boolean equalsIgnoreCase(String anotherString)

String.equalsIgnoreCase richiede che le stringhe abbiano la stessa lunghezza e che i punti di codice Unicode corrispondenti coincidano. I punti coincidono se sono identici oppure se Character.toLowerCase(Character.toUpperCase(int)) produce lo stesso risultato.

Un argomento null restituisce false; invocare il metodo su un ricevente null genera una NullPointerException. A differenza di questo metodo, equals distingue tra maiuscole e minuscole.

Il metodo non tiene conto delle impostazioni locali; per confronti dipendenti dalla lingua, usa Collator. Non considera ß equivalente a SS: le lunghezze sono diverse.

Esempi

public class Main {
    public static void main(String[] args) {
        System.out.println("Java".equalsIgnoreCase("jAvA"));
        System.out.println("Java".equals("jAvA"));
        System.out.println("Java".equalsIgnoreCase(null));
        System.out.println("ß".equalsIgnoreCase("SS"));
    }
}

Risultato

true
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