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

CKTIS / Java

String.compareTo — comparación lexicográfica

String.compareTo compara cadenas de forma lexicográfica. El signo del resultado determina el orden; cero significa que el contenido es igual.

Versión: Java SE 21; repository runtime, production runtime not attested

Sintaxis

public int compareTo(String anotherString)
// Usage: int result = left.compareTo(right);

String.compareTo devuelve un int: un resultado negativo significa que la cadena de la izquierda precede a la de la derecha; uno positivo significa que va después. Cero corresponde a la igualdad según equals.

La comparación distingue entre mayúsculas y minúsculas y utiliza los valores de las unidades de código UTF-16 (char), no reglas lingüísticas. El resultado es la diferencia entre las primeras unidades distintas; si una cadena es prefijo de la otra, es la diferencia de longitud. No des por hecho que el resultado solo puede ser -1, 0 o 1: comprueba el signo.

Un argumento null provoca una NullPointerException. Usa Collator para comparaciones que dependan del idioma.

Ejemplos

public class Main {
    public static void main(String[] args) {
        System.out.println("cat".compareTo("car"));
        System.out.println("car".compareTo("cart"));
        System.out.println("cat".compareTo("cat"));
        System.out.println("A".compareTo("a") < 0);
    }
}

Resultado

2
-1
0
true

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes