CKTIS / Java
Collator — comparar texto según las reglas lingüísticas
java.text.Collator compara texto según las reglas de un Locale elegido. Permite configurar qué diferencias se tienen en cuenta y cómo se tratan los caracteres Unicode compuestos.
Versión: Java SE 21; repository runtime, production runtime not attested
Sintaxis
Collator collator = Collator.getInstance(locale);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
int result = collator.compare(left, right);java.text.Collator es una clase abstracta para comparar cadenas de forma lingüística. Usa getInstance(locale) en lugar de depender del Locale predeterminado. El resultado de compare(left, right) es negativo, cero o positivo; no des por hecho que sea exactamente -1 o 1. Cero significa equivalencia según las reglas, no necesariamente una escritura idéntica.
setStrength selecciona los niveles que se distinguen: PRIMARY suele distinguir las letras base, SECONDARY también los acentos y TERTIARY además las mayúsculas y minúsculas. La asignación de las diferencias depende del locale. IDENTICAL resuelve las diferencias restantes, pero el resultado sigue dependiendo de la descomposición.
NO_DECOMPOSITION no descompone los caracteres; CANONICAL_DECOMPOSITION aplica la descomposición canónica, mientras que FULL_DECOMPOSITION aplica también la descomposición de compatibilidad. En RuleBasedCollator, la descomposición canónica es importante para los caracteres combinantes en un orden no canónico.
En la implementación del JDK, compartir un RuleBasedCollator puede provocar contención entre hilos; considera usar una instancia por hilo. Ámbito de esta entrada: Java SE 21; no se han verificado el entorno de ejecución del repositorio ni el de producción.
Ejemplos
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
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.