Collator  - AS3

Namnet på det faktiska språk-ID som används av det här Collator-objektet.

Det finns tre möjliga värden för namnet, beroende på operativsystemet och värdet på den requestedLocaleIDName-parameter som skickas till Collator()-konstruktorn.

1. Om det begärda språket inte var LocaleID.DEFAULT, och operativsystemet har stöd för det begärda språket, är det namn som returneras samma som egenskapen requestedLocaleIDName.
2. Om LocaleID.DEFAULT användes som värdet för parametern requestedLocaleIDName till konstruktorn, används det namn för det aktuella språket som specificeras av användarens operativsystem. Värdet LocaleID.DEFAULT bevarar användarens anpassade inställningar i operativsystemet. Om du skickar ett uttryckligt värde som requestedLocaleIDName-parameter ger det inte nödvändigtvis samma resultat som när du använder LocaleID.DEFAULT, även om de båda språknamnen är samma. Användaren kan ha anpassat språkinställningarna på datorn, och om du begär ett uttryckligt språk-ID i stället för att använda LocaleID.DEFAULT hämtar ditt program inte dessa anpassade inställningar.
3. Om systemet saknar stöd för det requestedLocaleIDName som anges i konstruktorn används ett reservspråk-ID i stället.

Relaterade API-element

När den här egenskapen är true räknas identiska strängar, samt strängar som skiljer sig åt endast vad gäller användningen av gemener/versaler, som lika. Till exempel returnerar compare("ABC", "abc") värdet true när egenskapen ignoreCase är inställd på true.

Konverteringen av gemener och versaler i strängen följer reglerna för angivet språk.

När egenskapen ignoreCase är false är gemena och versala bokstäver inte likvärdiga.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är true när Collator()-konstruktorns initialMode-parameter är inställd på Collator.MATCHING. Standardvärdet är false när Collator()-konstruktorns initialMode-parameter är inställd på Collator.SORTING.

Relaterade API-element

När den här egenskapen är true räknas vissa kinesiska och japanska teckenformer med hel och halv bredd som lika.

För att ge kompatibilitet med befintliga standarder för kinesiska och japanska teckenuppsättningar har Unicode teckenkoder med både hel- och halvbredd för vissa teckenformer. När egenskapen ignoreCharacterWidth till exempel är inställd på true returnerar compare("Ａｱ", "Aア") värdet true.

Om egenskapen ignoreCharacterWidth är false räknas teckenformer med hel och halv bredd inte som lika.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är false.

Relaterade API-element

När den här egenskapen är true räknas strängar som använder samma bastecken, men olika accenter eller diakritiska tecken, som lika. Till exempel returnerar compare("coté", "côte") värdet true när egenskapen ignoreDiacritics är true.

När ignoreDiacritics är false räknas bastecken med olika accenter eller diakritiska tecken inte som lika.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är false.

Relaterade API-element

När den här egenskapen är true räknas strängar, som bara skiljer sig åt med avseende på vilken typ av kana-tecken som används, som lika. compare("カナ", "かな") returnerar till exempel true när egenskapen ignoreKanaType är inställd på true.

Om ignoreKanaType är false räknas hiragana- och katakana-tecken som hänvisar till samma stavelse inte som lika.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är false.

Relaterade API-element

När den här egenskapen är true ignoreras symboltecken, som blanksteg, valutasymboler, matematiska symboler och andra typer av symboler, vid sorteringen och matchning. Till exempel räknas strängarna "OBrian", "O'Brian" och "O Brian" alla som lika när egenskapen ignoreSymbols är true.

Om egenskapen ignoreSymbols är false beaktas symboltecken i strängjämförelser.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är false.

Relaterade API-element

Status för den senaste åtgärden som detta Collator-objekt har utfört. lastOperationStatus anges när konstruktorn eller en metod för den här klassen anropas eller när en egenskap anges. Beskrivningarna av de olika metoderna innehåller information om möjliga värden.

Relaterade API-element

Styr hur numeriska värden som är inbäddade i strängar hanteras vid strängjämförelser.

När egenskapen numericComparison är true konverterar jämförelsemetoden tal som visas i strängar till numeriska värden för jämförelse.

När den här egenskapen är false behandlas tal som teckenkoder i jämförelsen, och de sorteras då i enlighet med reglerna för teckensortering i det angivna språket.

Om till exempel den här egenskapen är true för språk-ID:t "en-US" sorteras strängarna "version1", "version10" och "version2" i följande ordning: version1 < version2 < version10.

När den här egenskapen är false för "en-US" sorteras samma strängar i följande ordning: version1 < version10 < version2.

När den här egenskapen tilldelas ett värde, och det inte visas några varningar eller fel, ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Standardvärdet är false.

Relaterade API-element

Namnet på det begärda språk-ID som skickades till konstruktorn för det här Collator-objektet.

Om värdet LocaleID.DEFAULT användes returneras namnet "i-default". Det språk som faktiskt används kan skilja sig från det begärda språket när ett reservspråk används. Namnet på det faktiska språket kan hämtas med egenskapen actualLocaleIDName.

Relaterade API-element

Skapar ett nytt Collator-objekt för att skapa strängjämförelser i enlighet med reglerna för ett visst språk.

Ett reservspråk fastställs om det aktuella operativsystemet saknar stöd för det språk-ID som skickas i parametern requestedLocaleIDName. Om ett reservalternativ används ställs egenskapen lastOperationStatus in så att den anger vilken typ av reservalternativ som använts.

Parametern initialMode anger olika kollationsalternativ för allmän användning. Det kan ställas in på något av följande värden:

• CollatorMode.SORTING: Anger kollationsalternativ för allmän lingvistisk sortering, till exempel sortering av en lista med textsträngar som visas för en slutanvändare. I det här läget beaktas skillnader mellan versaler och gemener, diakritiska tecken och andra språkspecifika skillnader vid strängjämförelser.
• CollatorMode.MATCHING: Anger kollationsalternativ för allmän användning, till exempel för att fastställa om två strängar är likvärdiga. I det här läget ignoreras skillnader mellan versaler och gemener, diakritiska tecken o.s.v. vid strängjämförelser.

Nedan visas ett exempel på en sorterad lista som skapats med ett Collator-objekt med språk-ID:t "en-US" (engelska i USA) och alternativet CollatorMode.SORTING:

Som du ser ovan behandlas alla tecken som om de har olika värden, men i lingvistisk ordning.

Nedan visas ett exempel på en sorterad lista som skapats med ett Collator-objekt med språk-ID:t "en-US" (engelska i USA) och alternativet CollatorMode.MATCHING:

Som du ser ovan är vissa tecken i lingvistisk ordning och behandlas som om de har samma teckenvärde.

Om du vill styra sorteringsordningen ännu mer kan du ändra egenskaperna för Collator-objektet, till exempel för Collator.ignoreCase eller Collator.ignoreDiacritics.

Som referens följer ett liknande sorteringsexempel nedan, men den här gången med standardmetoden Array.sort(), som inte tar hänsyn till språk:

Som du ser ovan sorteras alla tecken bara efter det numeriska Unicode-värdet. Språkligt sett är det inte särskilt användbart.

Om användarens aktuella operativsysteminställningar ska användas skickar du det statiska värdet LocaleID.DEFAULT i parametern requestedLocaleIDName till konstruktorn.

Vissa språk har flera olika sorteringsordningar. I exempelvis Tyskland används en sorteringsordning för telefonkataloger och en annan för ordböcker. På kinesiska har ord ofta stöd för translitteration av tecken till pinyin. De här olika sorteringsordningarna kan väljas genom att ”kollationsnyckelordet” inkluderas i den sträng som skickas i parametern requestedLocaleIDName till konstruktorn.

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

Möjliga värden för kollationssträngen är följande, med de språk som påverkas inom parentes:

Om värdplattformen saknar stöd för den begärda kollationstypen används ett reservalternativ, och egenskapen lastOperationStatus ställs in så att den anger att ett reservalternativ använts. Du kan använda egenskapen actualLocaleIDName för att fastställa det värde som användes som reservalternativ, enligt följande exempel:

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

När konstruktorn slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

När det begärda språk-ID:t inte är tillgängligt ställs egenskapen lastOperationStatus in på något av följande:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Mer information om de varningsmeddelanden som visas ovan och andra möjliga värden för lastOperationStatus finns i beskrivningarna för klassen LastOperationStatus.

Relaterade API-element

Jämför två strängar och returnerar ett heltalsvärde, som anger om den första strängen är mindre än, lika med eller större än den andra strängen. Jämförelsen använder sorteringsordningsreglerna för det språk-ID som angetts i Collator()-konstruktorn.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Jämför två strängar och returnerar ett booleskt värde som anger om strängarna är likadana. Jämförelsen använder sorteringsordningsreglerna för det språk-ID som angetts i Collator()-konstruktorn.

När den här metoden anropas och slutförs felfritt ställs egenskapen lastOperationStatus in på:

• LastOperationStatus.NO_ERROR

I annat fall ställs egenskapen lastOperationStatus in på en av de konstanter som definieras i klassen LastOperationStatus.

Parametrar

Relaterade API-element

Visar alla språk-ID:n som stöds i den här klassen.

Om den här klassen inte stöds alls på det aktuella operativsystemet returnerar den här metoden värdet null.

1. Itererar igenom en array med språk-ID:n, bl.a. operativsystemets standardspråk (enligt LocaleID.DEFAULT)
2. Skapar ett Collator-objekt för varje språk-ID med läget "sorting" (standard).
3. Visar det begärda och faktiska språk-ID:t och värdet på egenskapen lastOperationStatus så att du kan se om ett reservspråk användes.
4. Sorterar en dataarray med hjälp av alla Collator-objekt och visar resultatet. Den resulterande ordningen är olika för olika språk.

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. Skapar ett Collator-objekt för användarens standardspråk med läget "matching".
2. Anger egenskapen Collator.ignoreDiacritics omväxlande som false och true
3. Jämför stränguppsättningar som innehåller diakritiska, gemena och versala tecken.
4. Visar hur jämförelserna ändras när egenskaperna Collator.ignoreDiacritics och Collator.ignoreCase ändras.

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);
                }
            }
        }
    }
}