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

CKTIS / Java

String.compareTo — comparação lexicográfica

String.compareTo compara cadeias de caracteres de forma lexicográfica. O sinal do resultado determina a ordem; zero significa que o conteúdo é igual.

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

Sintaxe

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

String.compareTo devolve um int: um resultado negativo significa que a cadeia à esquerda precede a cadeia à direita; um resultado positivo significa que vem depois. Zero corresponde à igualdade segundo equals.

A comparação distingue maiúsculas de minúsculas e utiliza os valores das unidades de código UTF-16 (char), não regras linguísticas. O resultado é a diferença entre as primeiras unidades diferentes; se uma cadeia for prefixo da outra, é a diferença de comprimento. Não assuma que o resultado é apenas -1, 0 ou 1: verifique o sinal.

Um argumento null provoca uma NullPointerException. Utilize Collator para comparações dependentes da língua.

Exemplos

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

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