CKTIS / Java
Collator — comparar texto segundo regras linguísticas
java.text.Collator compara texto segundo as regras de um Locale escolhido. Permite configurar quais as diferenças relevantes e como são tratados os caracteres Unicode compostos.
Versão: Java SE 21; repository runtime, production runtime not attested
Sintaxe
Collator collator = Collator.getInstance(locale);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
int result = collator.compare(left, right);java.text.Collator é uma classe abstrata para a comparação linguística de cadeias de caracteres. Utilize getInstance(locale) em vez de depender do Locale predefinido. O resultado de compare(left, right) é negativo, zero ou positivo; não parta do princípio de que é exatamente -1 ou 1. Zero significa equivalência segundo as regras, não necessariamente uma grafia idêntica.
setStrength seleciona os níveis distinguidos: PRIMARY distingue normalmente as letras de base, SECONDARY distingue também os acentos e TERTIARY distingue ainda maiúsculas de minúsculas. A atribuição das diferenças depende do locale. IDENTICAL resolve as diferenças restantes, mas o resultado continua a depender da decomposição.
NO_DECOMPOSITION não decompõe os caracteres; CANONICAL_DECOMPOSITION aplica a decomposição canónica, enquanto FULL_DECOMPOSITION aplica também a decomposição de compatibilidade. Para RuleBasedCollator, a decomposição canónica é importante no caso de caracteres combinantes em ordem não canónica.
Na implementação do JDK, um RuleBasedCollator partilhado pode causar contenção entre threads; considere uma instância separada por thread. Âmbito desta entrada: Java SE 21; o ambiente de execução do repositório e o ambiente de produção não estão atestados.
Exemplos
import java.text.Collator;
import java.util.Locale;
public class Main {
public static void main(String[] args) {
Collator collator = Collator.getInstance(Locale.US);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
System.out.println(collator.compare("abc", "ABC") == 0);
System.out.println(collator.compare("abc", "abd") < 0);
System.out.println(collator.compare("\u00E9", "e\u0301") == 0);
}
}Resultado
true true 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.