RuleBasedCollator Classe

Definição

[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

Herança

Object

JavaObject

Object

Collator

RuleBasedCollator

Atributos

RegisterAttribute

Comentários

RuleBasedCollator é uma subclasse concreta do Collator. Ele permite a personalização do Collator por meio de conjuntos de regras especificados pelo usuário. RuleBasedCollator foi projetado para ser totalmente compatível com o UCA (Algoritmo de Ordenação Unicode) e está em conformidade com o ISO 14651.

Um Collator é thread-safe somente quando congelado. Consulte #isFrozen() e android.icu.util.Freezable.

Os usuários são altamente incentivados a ler o Guia do Usuário para obter mais informações sobre o serviço de ordenação antes de usar essa classe.

Crie um RuleBasedCollator de uma localidade chamando o método de fábrica getInstance(Locale) na classe base Collator. Collator.getInstance(Locale) cria um objeto RuleBasedCollator com base nas regras de ordenação definidas pela localidade do argumento. Se uma ordenação ou atributos de ordenação personalizados for necessário, use o construtor RuleBasedCollator(String) com as regras apropriadas. O RuleBasedCollator personalizado baseará sua ordenação na ordenação raiz CLDR, ajustando novamente os atributos e as ordens dos caracteres na regra especificada adequadamente.

RuleBasedCollator fornece ordens de ordenação corretas para a maioria das localidades com suporte na UTI. Se dados específicos de uma localidade não estiverem disponíveis, os pedidos eventualmente retornarão à ordem de classificação raiz CLDR.

Para obter informações sobre a sintaxe da regra de ordenação e detalhes sobre a personalização, consulte a seção de personalização de ordenação do Guia do Usuário.

<forte>Observação</forte> de que há algumas diferenças entre a sintaxe da regra de ordenação usada no Java e no ICU4J:

<ul><li>De acordo com a documentação do JDK: <br>Modifier '!' : ativa a troca vogal-consoante thai/lao. Se essa regra estiver em vigor quando uma vogal tailandesa do intervalo \ U0E40-\ U0E44 precede uma consoante tailandesa do intervalo \ U0E01-\ U0E2E OU uma vogal lao do intervalo \ U0EC0-\ U0EC4 precede uma consoante lao do intervalo \ U0E81-\ U0EAE, em seguida, a vogal é colocada após a consoante para fins de ordenação. <br> Se uma regra estiver sem o modificador '!', a troca vogal-conso tailandesa/lao não será ativada. <RuleBasedCollator do br> ICU4J não dá suporte para desativar a troca vogal-consoante thai/lao, uma vez que a UCA afirma claramente que tem que ter suporte para garantir uma ordem de classificação correta. Se um '!' for encontrado, ele será ignorado.</li><li>Conforme mencionado na documentação do Collator da classe base, não há suporte para o modo de decomposição de compatibilidade.</li></ul>

<exemplos> fortes</fortes>

Criando RuleBasedCollators Personalizados: <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>

Concatenando regras para combinar 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>

Fazendo alterações em um RuleBasedCollator existente para criar um novo Collator objeto, acrescentando alterações à regra existente: <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>

Como alterar a ordem dos acentos sem espaçamento: <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>

Colocando uma nova ordem primária antes da configuração padrão, por exemplo, classificar caracteres em inglês antes ou depois de caracteres japoneses no japonês 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>

Essa classe não é subclassável

Java documentação para android.icu.text.RuleBasedCollator.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Project Open Source do Open Source e usadas de acordo com os termos descritos na Creative Commons 2.5.