Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Java

String.equalsIgnoreCase — comparação sem distinguir maiúsculas de minúsculas

String.equalsIgnoreCase compara cadeias de caracteres sem distinguir maiúsculas de minúsculas, independentemente das definições regionais. Devolve um boolean.

Versão: Java SE 21; repository runtime, production runtime not attested

Sintaxe

public boolean equalsIgnoreCase(String anotherString)

String.equalsIgnoreCase exige que as cadeias tenham o mesmo comprimento e que os pontos de código Unicode correspondentes coincidam. Os pontos coincidem se forem idênticos ou se Character.toLowerCase(Character.toUpperCase(int)) produzir o mesmo resultado.

Um argumento null resulta em false; invocar o método num recetor null lança uma NullPointerException. Ao contrário deste método, equals distingue maiúsculas de minúsculas.

O método não tem em conta as definições regionais; para comparações dependentes da língua, utilize Collator. Não considera ß equivalente a SS: os comprimentos são diferentes.

Exemplos

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

Resultado

true
false
false
false

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes