Collator  - AS3

O nome do ID de localidade real usado por este objeto Collator.

Há três possibilidades para o valor de nome, dependendo do sistema operacional e do valor do parâmetro requestedLocaleIDName passado ao construtor Collator().

1. Se o idioma solicitado não for LocaleID.DEFAULT e o sistema operacional oferecer suporte para o idioma solicitado, o nome retornado será o mesmo da propriedade requestedLocaleIDName.
2. Se LocaleID.DEFAULT foi usado como o valor do parâmetro requestedLocaleIDName para o construtor, o nome do idioma atual especificado pelo sistema operacional do usuário será usado. O valor LocaleID.DEFAULT preserva a configuração personalizada do usuário no sistema operacional. Observe que a passagem de um valor explícito como o parâmetrorequestedLocaleIDName não tem necessariamente o mesmo resultado que o uso de LocaleID.DEFAULT, mesmo que os dois nomes de ID de idioma sejam iguais. O usuário poderia ter personalizado as configurações de local na máquina dele e, ao solicitar um nome de ID de local explícito em vez de usar LocaleID.DEFAULT, o aplicativo não recuperaria as configurações personalizadas.
3. Se o sistema não suporta o requestedLocaleIDName especificado no construtor, é fornecido um nome de ID de local de retrocesso.

Elementos da API relacionados

Quando esta propriedade é definida como true, strings idênticas e strings cuja única diferença é uma questão de maiúsculas/minúsculas são consideradas iguais. Por exemplo, compare("ABC, "abc") retornará true quando a propriedade ignoreCase for definida como true.

A conversão de maísculas/minúsculas da string seguirá as regras do idioma especificado.

Quando a propriedade ignoreCase for falsa, os caracteres em letra minúscula e maiúscula não serão iguais um a ou outro.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Caso contrário, a propriedade lastOperationStatus é definida como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é true quando o parâmetro Collator() do initialMode do construtor está definido como Collator.MATCHING. O valor padrão é false quando o parâmetro Collator() do initialMode do construtor está definido como Collator.SORTING.

Elementos da API relacionados

Quando esta propriedade for verdadeira, as formas de largura total e meia largura de alguns caracteres chineses e japoneses serão consideradas iguais.

Para a compatibilidade com padrões existentes de conjuntos de caracteres chineses e japoneses, o Unicode fornece códigos de caracteres tanto da largura cheia como das formas da semilargura de alguns caracteres. Por exemplo, quando a propriedade ignoreCharacterWidth é definida como true, compare("Ａｱ", "A") retorna true.

Se a propriedade ignoreCharacterWidth for definida como false, as formas de largura total e as formas de meia-largura não serão iguais uma a outra.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é false.

Elementos da API relacionados

Quando esta propriedade for definida como verdadeira, as strings que usam os mesmos caracteres básicos, mas acentos diferentes ou outras marcas diacríticas, serão avaliadas como iguais. Por exemplo compare ("coté", "côte") retornará true quando a propriedade ignoreDiacritics for definida como true.

Quando ignoreDiacritics for definido como false, os caracteres baseados em marcas diacríticas ou acentos não serão iguais um ao outro.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é false.

Elementos da API relacionados

Quando esta propriedade é definida como true, strings cuja única diferença é o tipo de caractere kana que é usado são consideradas iguais. Por exemplo, compare("カナ", "��") retornará true quando a propriedade ignoreKanaType for definida como true.

Se ignoreKanaType for definido como false, os caracteres hiragana e katakana que se referem à mesma sílaba não serão iguais um ao outro.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é false.

Elementos da API relacionados

Quando esta propriedade é definida como true, os caracteres de símbolo, como espaços, símbolos de moeda, símbolos matemáticos, e outros tipos de símbolos são ignorados na classificação ou na correspondência. Por exemplo os cadeias "OBrian", "O'Brian" e "O Brian" seriam todos tratados como iguais quando o ignoreSymbols a propriedade é definida para true.

Se a propriedade ignoreSymbols for falsa, os caracteres de símbolo serão considerados em comparações de strings.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é false.

Elementos da API relacionados

O status da operação mais recente que este objeto Collator executou. A propriedade lastOperationStatus será definida sempre que o construtor ou um método desta classe forem chamados ou sempre que outra propriedade for definida. Para ver os valores possíveis, consulte a descrição de cada método.

Elementos da API relacionados

Controla como os valores numéricos incorporados em strings serão tratados durante a comparação de strings.

Quando a propriedade numericComparison for definida como true, o método compare converterá os números que aparecerem nas strings em valores numéricos para comparação.

Quando esta propriedade é definida como false, a comparação trata os números como códigos de caracteres e os classifica segundo as regras para classificar caracteres no idioma especificado.

Por exemplo, quando esta propriedade for verdadeira para o ID de idioma "en_US", então as strings "version1", "version10" e "version2" serão classificadas na seguinte ordem: version1 <version2 <version10.

Quando esta propriedade for falsa para "en_US", essas mesmas strings serão classificadas na seguinte ordem: version1 <version10 <version2.

Quando um valor é atribuído a esta propriedade e não há erros nem avisos, a propriedade lastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

O valor padrão é false.

Elementos da API relacionados

O nome do ID da localidade solicitada que foi passado ao construtor deste objeto Collator.

Se o valor LocaleID.DEFAULT tiver sido usado, então o nome retornado será "i-default". A localidade real usada pode diferenciar-se da localidade solicitada quando uma localidade de retorno é aplicada. É possível recuperar nome do local real pode ser recuperado usando o actualLocaleIDName propriedade.

Elementos da API relacionados

Constrói um novo objeto de Collator para fornecer comparações de strings segundo as convenções de uma localidade especificada.

Se o sistema operacional atual não suportar o ID do idioma despachado no parâmetro requestedLocaleIDName, um idioma de retorno será determinado. Se um retorno for usado, a propriedade lastOperationStatus será definida para indicar o tipo de retorno.

O parâmetro initialMode define várias opções de colação de usos gerais. Pode ser definido para um dos seguintes valores:

• CollatorMode.SORTING: as opções de colação para usos de classificação linguística gerais, tais como classificação de uma lista de strings de texto que serão exibidos a um usuário final. Neste modo, as diferenças de letras maiúsculas e minúsculas, caracteres acentuados e outras diferenças específicas do idioma serão consideradas ao fazer comparações de strings.
• CollatorMode.MATCHING: as opções de colação de conjuntos para usos gerais, tais como a determinação se duas cadeias são equivalentes. Neste modo, as diferenças de letras maiúsculas e minúsculas, caracteres acentuados e outras diferenças específicas do idioma serão consideradas ao fazer comparações de strings.

Veja um exemplo de lista classificada criada usando um Collator com o ID local "en-US" (inglês dos Estados Unidos) e a opção CollatorMode.SORTING:

Como mostrado acima, todos os caracteres são tratados como se tivessem valores diferentes, mas na ordem linguística.

Veja um exemplo de lista classificada criada usando um Collator com o ID local "en-US" (inglês dos Estados Unidos) e a opção CollatorMode.MATCHING:

Como exibido acima, alguns caracteres estão na ordem linguística e são tratados como se tivessem o mesmo valor de caractere.

Para um controle aprimorado da ordem, você pode modificar as propriedades collator como Collator.ignoreCase ou Collator.ignoreDiacritics.

Para referência, veja um exemplo de classificação correspondente usando o padrão Array.sort(), que não reconhece o local:

Como você pode ver acima, todos os caracteres são classificados simplesmente na ordem de valor numérico de Unicode. Não faz muito sentido linguisticamente.

Para usar as preferências de sistema operacional atuais do usuário, passe o valor estático LocaleID.DEFAULT do parâmetro requestedLocaleIDName para o construtor.

Algumas localidades têm várias variantes de ordem de classificação. Por exemplo, em alemão uma ordem de classificação é usada para catálogos telefônicos e outra é usada para dicionários. Em chinês, as palavras geralmente são suportadas pela transliteração dos caracteres no pinyin. Estas ordens de classificação diferentes podem ser selecionadas pela inclusão da palavra-chave "colação" na cadeia que é passada no parâmetro requestedLocaleIDName para o construtor.

         var germanPhonebook:LocaleID = new LocaleID("de-DE@collation=phonebook");
         var chinesePinyin:LocaleID = new LocaleID("zh-Hant@collation=pinyin");
         

Os valores possíveis da string de agrupamento são os seguintes, com os idiomas afetados exibidos entre parênteses:

Se a plataforma host não suportar o tipo de colação solicitado, um retorno será usado, e a propriedade lastOperationStatus será definida para indicar que um retorno foi selecionado. Você pode usar a propriedade actualLocaleIDName para determinar o valor que foi usado como um fallback, como é mostrado no seguinte exemplo:

         var collator:Collator = new Collator("fr-FR");
         if (collator.lastOperationStatus == LastOperationStatus.USING_FALLBACK_WARNING)
         {
           trace ("Using fallback locale: " + collator.actualLocaleIDName);
         }
         

Quando o construtor conclui com sucesso, a propriedadelastOperationStatus é definida como:

• LastOperationStatus.NO_ERROR

Quando a localidade solicitada ID não é disponível, então o lastOperationStatus a propriedade é definida como um do seguinte:

• LastOperationStatus. USING_FALLBACK_WARNING
• LastOperationStatus. USING_DEFAULT_WARNING

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Para detalhes sobre os avisos listados acima e outros valores possíveis de lastOperationStatus, veja as descrições na classe LastOperationStatus.

Elementos da API relacionados

Compara duas strings e retorna um valor inteiro que indica se a primeira string é menor, igual ou maior que a segunda string. A comparação usa as regras de ordem de classificação da ID de local que foi especificada no construtor Collator().

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Compara duas strings e retorna um valor booliano que indica se as strings são iguais. A comparação usa as regras de ordem de classificação da ID de local que foi especificada no construtor Collator().

Quando este método é invocado e conclui com sucesso, a propriedade lastOperationStatus é configurada como:

• LastOperationStatus.NO_ERROR

Do contrário, a propriedade lastOperationStatus é configurada como uma das constantes definidas na classe LastOperationStatus.

Parâmetros

Elementos da API relacionados

Lista todos os nomes de ID de local suportados por essa classe.

Se esta classe não for suportada de nenhuma maneira no sistema operacional atual, este método retornará um valor nulo.

1. Repete por uma matriz de nomes de ID de localidade, inclusive a localidade padrão de ID do sistema operacional (como especificado por LocaleID.DEFAULT)
2. Cria um objeto Collator de cada nome de ID de localidade usando o modo de "classificação" (o padrão).
3. Exibe os nomes de ID de localidade solicitada e real e o valor da propriedade lastOperationStatus de forma que você pode ver se uma localidade de emergência foi usada.
4. Classifica uma matriz de dados que usa cada intercalador e exibe os resultados. A ordem resultante é diferente para cada localidade.

package {
    import flash.globalization.Collator;
    import flash.globalization.LocaleID;

    public class CollatorExample1
    {
        public var col:Collator;
        
        public function CollatorExample1():void
        {        
            var localeNames:Array = [LocaleID.DEFAULT,
                                     "de-DE", "sv-SE",
                                     "fr-FR", "lt-LT",
                                     "es-ES"];
            
            var testSortData:Array = [
                "y ", "i ", "k ", // Latvian
                "acxa ", "acha ", "adxa ", // es_traditional
                "n ", "ö ", "o ", "z ", "vu ", "wo ", // sw
                "däd ", "daed ", // de
                "öf ", "of ", // de_dictionary
                "côte ", "coté " // fr
            ];
            
            for each (var localeName:String in localeNames) {
            
                col = new Collator(localeName);
                
                trace("LocaleID requested: " + col.requestedLocaleIDName 
                       + "; actual: " + col.actualLocaleIDName);
                       
                trace("Last Operation Status: " + col.lastOperationStatus );
                
                var result:Array = testSortData.sort(col.compare);
                        
                trace ("sorted data: " + result); 
            }
        }      
    }
}

1. Cria um objeto Collator para a localidade padrão do usuário usando o modo de "correspondência".
2. Define alternadamente a propriedade Collator.ignoreDiacritics para false e true
3. Compara conjuntos de strings que contêm sinais diacríticos e caracteres maiúsculos e minúsculos.
4. Demonstra como as comparações se alteram quando as propriedades Collator.ignoreDiacritics e Collator.ignoreCase são alteradas.

package {
    import flash.display.Sprite;
    import flash.globalization.Collator;
    import flash.globalization.CollatorMode;
    import flash.globalization.LocaleID;
    
    public class CollatorExample2 extends Sprite
    {
        public var col:Collator;
        public var testMatchData:Array = ["cote", "Cote", "côte", "coté"];
        public var wordToMatch:String = "Cote";
        
        public function CollatorExample2()
        {
            col = new Collator( LocaleID.DEFAULT, CollatorMode.MATCHING );

            trace("LocaleID requested: " + col.requestedLocaleIDName 
                    + "; actual: " + col.actualLocaleIDName);
                    
            trace("Last Operation Status: " + col.lastOperationStatus );

            trace('\n' + "ignoreCase = " + col.ignoreCase);
            trace("ignoreDiacritics = " + col.ignoreDiacritics);

            compareString(testMatchData, wordToMatch) // All variations of the word cote match

            col.ignoreDiacritics = false;
            trace('\n' + "ignoreDiacritics = false");

            compareString(testMatchData, wordToMatch) // Variations with different diacritics will not match

            col.ignoreCase = false;
            trace('\n' + "ignoreCase = false");

            compareString(testMatchData, wordToMatch) // Variations with different case will not match
        }
    
        private function compareString(stringArray:Array, keyword:String):void
        {
            for each(var s:String in stringArray)
            {
                if(col.equals(s, keyword))    
                {
                    trace(keyword + " = " + s);
                }
            }
        }
    }
}