CKTIS / Java
Collator — comparer du texte selon les règles linguistiques
java.text.Collator compare du texte selon les règles d’un Locale choisi. Il permet de définir les différences prises en compte et la manière dont les caractères Unicode composés sont traités.
Version : Java SE 21; repository runtime, production runtime not attested
Syntaxe
Collator collator = Collator.getInstance(locale);
collator.setStrength(Collator.PRIMARY);
collator.setDecomposition(Collator.CANONICAL_DECOMPOSITION);
int result = collator.compare(left, right);java.text.Collator est une classe abstraite destinée à la comparaison linguistique de chaînes. Utilisez getInstance(locale) plutôt que de vous fier au Locale par défaut. Le résultat de compare(left, right) est négatif, nul ou positif ; ne supposez pas qu’il vaut exactement -1 ou 1. Zéro signifie que les valeurs sont équivalentes selon les règles, pas nécessairement que leur écriture est identique.
setStrength définit les niveaux de distinction : PRIMARY distingue généralement les lettres de base, SECONDARY distingue aussi les accents et TERTIARY distingue également la casse. La manière dont ces différences sont prises en compte dépend du locale. IDENTICAL départage les différences restantes, mais le résultat dépend toujours de la décomposition.
NO_DECOMPOSITION ne décompose pas les caractères ; CANONICAL_DECOMPOSITION applique la décomposition canonique, tandis que FULL_DECOMPOSITION applique aussi la décomposition de compatibilité. Avec RuleBasedCollator, la décomposition canonique est importante pour les caractères combinants dans un ordre non canonique.
Dans l’implémentation du JDK, un RuleBasedCollator partagé peut entraîner une contention entre threads ; envisagez une instance distincte par thread. Périmètre de cette entrée : Java SE 21 ; l’environnement d’exécution du dépôt et celui de production ne sont pas attestés.
Exemples
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);
}
}Résultat
true true true
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.