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.