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

CKTIS / Java

String.compareToIgnoreCase(String) — comparar cadeias sem distinguir maiúsculas de minúsculas

Compara duas cadeias de caracteres por ordem lexicográfica, sem distinguir maiúsculas de minúsculas, e determina a sua ordem pelo sinal do `int` devolvido.

Versão: Java SE 21

Sintaxe

public int compareToIgnoreCase(String str)

int result = left.compareToIgnoreCase(right);

String.compareToIgnoreCase(String) é um método de instância de String. A chamada left.compareToIgnoreCase(right) compara duas cadeias por ordem lexicográfica, sem distinguir maiúsculas de minúsculas. Devolve um int: < 0 significa que left vem antes de right, == 0 que as cadeias são equivalentes nesta comparação e > 0 que left vem depois de right. Verifica o sinal em vez de assumires que o resultado é sempre -1, 0 ou 1.

No Java SE 21, o resultado tem o mesmo sinal que o de compareTo após aplicar Character.toLowerCase(Character.toUpperCase(cp)) a cada ponto de código Unicode cp das duas cadeias. As cadeias originais não são alteradas. O método não tem em conta as regras regionais. Para ordenar texto segundo as regras de uma língua específica, usa java.text.Collator com a Locale adequada.

Usa compareTo quando a distinção entre maiúsculas e minúsculas deve influenciar a ordem lexicográfica, e equalsIgnoreCase quando só precisas de um boolean que indique se as cadeias são iguais sem essa distinção. Se left ou right for null, left.compareToIgnoreCase(right) lança uma NullPointerException. Se left não for null, left.equalsIgnoreCase(null) devolve false.

Exemplos

public class Main {
    public static void main(String[] args) {
        String first = "apple";
        String second = "Banana";

        System.out.println(first.compareToIgnoreCase("APPLE"));
        System.out.println(Integer.signum(first.compareToIgnoreCase(second)));
        System.out.println(Integer.signum(second.compareToIgnoreCase(first)));
    }
}

Resultado

0
-1
1

`apple` e `APPLE` dão `0`. `apple` vem antes de `Banana`; ao inverter a comparação, o sinal muda. As duas últimas linhas usam `Integer.signum` para reduzir os resultados a `-1` e `1`.

Lições relacionadas

  • Java · Lição 63 · Básico · Versão: 2

Fontes