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

CKTIS / Java

String.compareToIgnoreCase(String) — comparar cadenas sin distinguir mayúsculas de minúsculas

Compara dos cadenas en orden lexicográfico sin distinguir mayúsculas de minúsculas y determina su orden a partir del signo del `int` devuelto.

Versión: Java SE 21

Sintaxis

public int compareToIgnoreCase(String str)

int result = left.compareToIgnoreCase(right);

String.compareToIgnoreCase(String) es un método de instancia de String. La llamada left.compareToIgnoreCase(right) compara dos cadenas en orden lexicográfico sin distinguir mayúsculas de minúsculas. Devuelve un int: < 0 significa que left va antes que right, == 0 que ambas cadenas son equivalentes en esta comparación y > 0 que left va después de right. Comprueba el signo en vez de suponer que el resultado siempre es -1, 0 o 1.

En Java SE 21, el resultado tiene el mismo signo que el de compareTo tras aplicar Character.toLowerCase(Character.toUpperCase(cp)) a cada punto de código Unicode cp de ambas cadenas. Las cadenas originales no cambian. El método no tiene en cuenta las reglas regionales. Para ordenar texto según las reglas de un idioma concreto, usa java.text.Collator con la Locale adecuada.

Usa compareTo si las mayúsculas y las minúsculas deben influir en el orden lexicográfico, y equalsIgnoreCase si solo necesitas un boolean que indique si las cadenas son iguales sin distinguir mayúsculas de minúsculas. Si left o right es null, left.compareToIgnoreCase(right) lanza una NullPointerException. Si left no es null, left.equalsIgnoreCase(null) devuelve false.

Ejemplos

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` y `APPLE` dan `0`. `apple` va antes que `Banana`; al invertir la comparación, cambia el signo. Las dos últimas líneas usan `Integer.signum` para convertir los resultados en `-1` y `1`.

Lecciones relacionadas

  • Java · Lección 63 · Básico · Versión: 2

Fuentes