RuleBasedCollator Classe

Définition

[Android.Runtime.Register("android/icu/text/RuleBasedCollator", ApiSince=24, DoNotGenerateAcw=true)]
public sealed class RuleBasedCollator : Android.Icu.Text.Collator

[<Android.Runtime.Register("android/icu/text/RuleBasedCollator", ApiSince=24, DoNotGenerateAcw=true)>]
type RuleBasedCollator = class
    inherit Collator

Héritage

Object

JavaObject

Object

Collator

RuleBasedCollator

Attributs

RegisterAttribute

Remarques

RuleBasedCollator est une sous-classe concrète de Collator. Elle permet la personnalisation du Collator via des ensembles de règles spécifiés par l’utilisateur. RuleBasedCollator est conçu pour être entièrement conforme à l’algorithme de classement Unicode (UCA) et est conforme à ISO 14651.

Un collator est thread-safe uniquement lorsqu’il est figé. Voir #isFrozen() et android.icu.util.Freezable.

Les utilisateurs sont fortement encouragés à lire le Guide utilisateur pour plus d’informations sur le service de classement avant d’utiliser cette classe.

Créez un RuleBasedCollator à partir d’un paramètre régional en appelant la méthode de fabrique getInstance(Locale) dans la classe de base Collator. Collator.getInstance(Locale) crée un objet RuleBasedCollator basé sur les règles de classement définies par les paramètres régionaux de l’argument. Si un classement personnalisé ou des attributs est requis, utilisez le constructeur RuleBasedCollator(String) avec les règles appropriées. RuleBasedCollator personnalisé base son classement sur le classement racine CLDR, tout en réajustant les attributs et les ordres des caractères dans la règle spécifiée en conséquence.

RuleBasedCollator fournit des commandes de classement correctes pour la plupart des paramètres régionaux pris en charge dans l’ICU. Si des données spécifiques pour des paramètres régionaux ne sont pas disponibles, les commandes reviennent finalement à l’ordre de tri racine CLDR.

Pour plus d’informations sur la syntaxe de règle de classement et les détails sur la personnalisation, reportez-vous à la section Personnalisation du classement du Guide utilisateur.

< >forte note</forte> qu’il existe des différences entre la syntaxe de règle de classement utilisée dans Java et ICU4J :

<ul><li>Selon la documentation JDK : <br>Modificateur ' !' : Active le voyelle thaï/lao-consonant permutation. Si cette règle est en vigueur lorsqu’une voyelle thaïlandaise de la plage \ ; U0E40-\ ; U0E44 précède une consonne thaïlandaise de la plage \ ; U0E01-\ ; U0E2E OR a Voyelle Lao de la plage \ ; U0EC0-\ ; U0EC4 précède une consonne lao de la plage \ ; U0E81-\ ; U0EAE puis le voyelle est placé après la consonne à des fins de classement. <br> Si une règle est sans le modificateur ' !', la voyelle thaï/lao-consonante n’est pas activée. <br> ICU4J RuleBasedCollator ne prend pas en charge la désactivation de la voyelle thaï/lao voyelle-consonante, car l’UCA indique clairement qu’il doit être pris en charge pour garantir un ordre de tri correct. Si un ' !' est rencontré, il est ignoré.</li li><>Comme mentionné dans la documentation de la classe de base Collator, le mode de décomposition de compatibilité n’est pas pris en charge.</li></ul>

<exemples> forts</forts>

Création de RuleBasedCollators personnalisés : <blockquote>

String simple = "& a < b < c < d";
            RuleBasedCollator simpleCollator = new RuleBasedCollator(simple);

            String norwegian = "& a , A < b , B < c , C < d , D < e , E "
                               + "< f , F < g , G < h , H < i , I < j , "
                               + "J < k , K < l , L < m , M < n , N < "
                               + "o , O < p , P < q , Q <r , R <s , S < "
                               + "t , T < u , U < v , V < w , W < x , X "
                               + "< y , Y < z , Z < \u00E5 = a\u030A "
                               + ", \u00C5 = A\u030A ; aa , AA < \u00E6 "
                               + ", \u00C6 < \u00F8 , \u00D8";
            RuleBasedCollator norwegianCollator = new RuleBasedCollator(norwegian);

</blockquote>

Concaténation de règles pour combiner Collators : <blockquote>

// Create an en_US Collator object
            RuleBasedCollator en_USCollator = (RuleBasedCollator)
                Collator.getInstance(new Locale("en", "US", ""));
            // Create a da_DK Collator object
            RuleBasedCollator da_DKCollator = (RuleBasedCollator)
                Collator.getInstance(new Locale("da", "DK", ""));
            // Combine the two
            // First, get the collation rules from en_USCollator
            String en_USRules = en_USCollator.getRules();
            // Second, get the collation rules from da_DKCollator
            String da_DKRules = da_DKCollator.getRules();
            RuleBasedCollator newCollator =
                                        new RuleBasedCollator(en_USRules + da_DKRules);
            // newCollator has the combined rules

</blockquote>

Apporter des modifications à un RuleBasedCollator existant pour créer un Collator objet, en ajoutant des modifications à la règle existante : <blockquote>

// Create a new Collator object with additional rules
            String addRules = "& C < ch, cH, Ch, CH";
            RuleBasedCollator myCollator =
                new RuleBasedCollator(en_USCollator.getRules() + addRules);
            // myCollator contains the new rules

</blockquote>

Comment modifier l’ordre des accents non interlignes : <blockquote>

// old rule with main accents
            String oldRules = "= \u0301 ; \u0300 ; \u0302 ; \u0308 "
                            + "; \u0327 ; \u0303 ; \u0304 ; \u0305 "
                            + "; \u0306 ; \u0307 ; \u0309 ; \u030A "
                            + "; \u030B ; \u030C ; \u030D ; \u030E "
                            + "; \u030F ; \u0310 ; \u0311 ; \u0312 "
                            + "< a , A ; ae, AE ; \u00e6 , \u00c6 "
                            + "< b , B < c, C < e, E & C < d , D";
            // change the order of accent characters
            String addOn = "& \u0300 ; \u0308 ; \u0302";
            RuleBasedCollator myCollator = new RuleBasedCollator(oldRules + addOn);

</blockquote>

En plaçant un nouvel ordre principal avant le paramètre par défaut, par exemple, trier les caractères anglais avant ou après les caractères japonais dans le japonais Collator: <blockquote>

// get en_US Collator rules
            RuleBasedCollator en_USCollator
                                   = (RuleBasedCollator)Collator.getInstance(Locale.US);
            // add a few Japanese characters to sort before English characters
            // suppose the last character before the first base letter 'a' in
            // the English collation rule is \u2212
            String jaString = "& \u2212 <\u3041, \u3042 <\u3043, "
                              + "\u3044";
            RuleBasedCollator myJapaneseCollator
                         = new RuleBasedCollator(en_USCollator.getRules() + jaString);

</blockquote>

Cette classe n’est pas sous-classable

Java documentation pour android.icu.text.RuleBasedCollator.

Les parties de cette page sont des modifications basées sur le travail créé et partagé par Android Open Source et utilisées en fonction des termes décrits dans la Creative Commons 2.5 Attribution License.