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

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.

Fontes