Collator  - AS3

De naam van de werkelijke landinstellings-id die door dit Collator-object wordt gebruikt.

Er zijn drie mogelijke waarden voor de naam, afhankelijk van het besturingssysteem en de waarde van de requestedLocaleIDName-parameter die wordt doorgegeven aan de Collator()-constructor.

1. Als de aangevraagde landinstelling niet gelijk is aan LocaleID.DEFAULT en het besturingssysteem ondersteuning voor de aangevraagde landinstelling biedt, is de geretourneerde naam gelijk aan de eigenschap requestedLocaleIDName.
2. Als LocaleID.DEFAULT is gebruikt als waarde voor de parameter requestedLocaleIDName aan de constructor, wordt de naam van de huidige landinstelling zoals opgegeven door het besturingssysteem van de gebruiker gebruikt. Met de waarde LocaleID.DEFAULT blijft de aangepaste gebruikersinstelling in het besturingssysteem behouden. Als u een expliciete waarde doorgeeft als parameter requestedLocaleIDName, krijgt u niet noodzakelijkerwijs hetzelfde resultaat als wanneer u LocaleID.DEFAULT gebruikt, ook al zijn beide namen voor de landinstellings-id's gelijk. Misschien heeft de gebruiker de landinstellingen op zijn computer aangepast. Doordat u een expliciete naam van een landinstellings-id aanvraagt (en niet LocaleID.DEFAULT gebruikt), worden deze aangepaste instellingen niet door uw toepassing opgehaald.
3. Als het systeem geen ondersteuning biedt voor derequestedLocaleIDName die in de constructor is opgegeven, wordt een fallback-landinstellings-id gebruikt.

Verwante API-elementen

Wanneer deze eigenschap is ingesteld op true, worden identieke tekenreeksen die alleen verschillen in het gebruik van hoofdletters en kleine letters als gelijkwaardig beschouwd. Zo retourneert compare("ABC", "abc") bijvoorbeeld true wanneer de eigenschap ignoreCase is ingesteld op true.

De conversie van hoofdletters naar kleine letters van de tekenreeks volgt de regels van de opgegeven landinstelling.

Wanneer de eigenschap ignoreCase is ingesteld op false, zijn hoofdletters en kleine letters niet gelijkwaardig.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Anders wordt de lastOperationStatus-eigenschap ingesteld op een van de constanten die in de LastOperationStatus-klasse zijn gedefinieerd.

De standaardwaarde is true wanneer de Collator()-constructorparameter initialMode is ingesteld op Collator.MATCHING. De standaardwaarde is false wanneer de Collator()-constructorparameter initialMode is ingesteld op Collator.SORTING.

Verwante API-elementen

Wanneer deze eigenschap is ingesteld op true, worden vormen in de halve breedte en vormen in de volledige breedte van bepaalde Chinese en Japanse tekens als gelijkwaardig beschouwd.

Voor compatibiliteit met bestaande standaarden voor Chinese en Japanse tekensets voorziet Unicode voor sommige tekens in tekencodes voor tekenvormen over volle breedte en tekenvormen over halve breedte. Wanneer de eigenschap ignoreCharacterWidth bijvoorbeeld is ingesteld op true, retourneert compare("Ａｱ", "Aア") de waarde true.

Als de eigenschap ignoreCharacterWidth is ingesteld op false, zijn tekenvormen over volle en van halve breedte niet aan elkaar gelijk.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

De standaardwaarde is false.

Verwante API-elementen

Wanneer deze eigenschap is ingesteld op true, worden tekenreeksen die dezelfde basistekens gebruiken, maar die verschillen in het type accent of diakritische markering als gelijkwaardig beschouwd. Zo retourneert compare("coté", "côte") bijvoorbeeld true wanneer de eigenschap ignoreDiacritics is ingesteld op true.

Wanneer de eigenschap ignoreDiacritics is ingesteld op false, worden basistekens met diakritische tekens of accenten niet als gelijkwaardig beschouwd.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

De standaardwaarde is false.

Verwante API-elementen

Wanneer deze eigenschap is ingesteld op true, worden tekenreeksen die alleen verschillen in het type kana-teken als gelijkwaardig beschouwd. compare("カナ", "かな") retourneert bijvoorbeeld true als de eigenschap ignoreKanaType is ingesteld op true.

Als de eigenschap ignoreKanaType is ingesteld op false, zijn hiragana- en katakana-tekens die naar dezelfde lettergreep verwijzen niet gelijkwaardig.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

De standaardwaarde is false.

Verwante API-elementen

Wanneer deze eigenschap is ingesteld op true, worden symbooltekens zoals spaties, valutasymbolen, wiskundige symbolen en andere typen symbolen genegeerd bij het sorteren. De tekenreeksen 'OBrian', 'O'Brian' en 'O Brian' worden bijvoorbeeld allemaal gelijk behandeld wanneer de ignoreSymbols-eigenschap op true is ingesteld.

Als de eigenschap ignoreSymbols false is, wordt er in tekenreeksvergelijkingen rekening gehouden met symbooltekens.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

De standaardwaarde is false.

Verwante API-elementen

De status van de meest recente bewerking die door dit object Collator is uitgevoerd. lastOperationStatus wordt ingesteld wanneer de constructor of een methode van deze klasse wordt aangeroepen of wanneer een eigenschap wordt ingesteld. Zie de beschrijving onder elke methode voor de mogelijke waarden.

Verwante API-elementen

Geeft aan hoe numerieke waarden die zijn ingesloten in tekenreeksen worden verwerkt bij het vergelijken van tekenreeksen.

Wanneer de eigenschap numericComparison is ingesteld op true, converteert de vergelijkingsmethode getallen in tekenreeksen naar numerieke waarden voor onderlinge vergelijking.

Wanneer deze eigenschap is ingesteld op false, behandelt de vergelijking getallen als tekencodes en worden deze gesorteerd volgens de regels voor het sorteren van tekens in de opgegeven landinstelling.

Wanneer deze eigenschap bijvoorbeeld true is voor de landinstellings-id 'en-US', worden de tekenreeksen 'version1', 'version10', en 'version2' in de volgende volgorde gesorteerd: version1 < version2 < version10.

Wanneer deze eigenschap false is voor 'en-US', worden dezelfde tekenreeksen in de volgende volgorde gesorteerd: version1 < version10 < version2.

Wanneer u een waarde toekent aan deze eigenschap en er treden geen fouten of waarschuwingsberichten op, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

De standaardwaarde is false.

Verwante API-elementen

De naam van de aangevraagde landinstellings-id die is doorgegeven aan de constructor van dit Collator-object.

Als u de waarde LocaleID.DEFAULT hebt gebruikt, is de geretourneerde naam 'i-default'. Als een fallback-landinstelling wordt toegepast, kan de werkelijk gebruikte landinstelling afwijken van de aangevraagde landinstelling. De naam van de werkelijke landinstelling kan worden opgehaald met de eigenschap actualLocaleIDName.

Verwante API-elementen

Maakt een nieuw Collator-object waarmee tekenreeksen met elkaar kunnen worden vergeleken volgens de conventies van een opgegeven landinstelling.

Als het huidige besturingssysteem geen ondersteuning biedt voor de landinstellings-id die in de parameter requestedLocaleIDName wordt doorgegeven, wordt er een fallback-landinstelling bepaald. Als er een fallback wordt gebruikt, wordt de eigenschap lastOperationStatus ingesteld zodat deze het fallback-type aangeeft.

De initialMode-parameter stelt verschillende collatie-opties in voor algemeen gebruik. Deze kan een van de volgende waarden hebben:

• CollatorMode.SORTING: stelt sorteeropties in voor algemene linguïstische sorteertoepassingen, zoals het sorteren van een lijst teksttekenreeksen die aan een eindgebruiker worden weergegeven. In deze modus wordt er tijdens tekenreeksvergelijkingen rekening gehouden met het verschil tussen hoofdletters en kleine letters, tekens met accent en andere verschillen die specifiek zijn voor de landinstelling.
• CollatorMode.MATCHING: stelt sorteeropties in voor algemeen gebruik, zoals om te bepalen of twee tekenreeksen equivalent zijn. In deze modus wordt er tijdens tekenreeksvergelijkingen geen rekening gehouden met het verschil tussen hoofdletters en kleine letters, tekens met accent enzovoort.

Hier is een voorbeeld van een gesorteerde lijst die is gemaakt met een Collator met de landinstellings-id 'en-US' (Engels in de VS) en de CollatorMode.SORTING-optie:

Zoals hierboven is weergegeven, worden alle tekens behandeld alsof ze verschillende waarden hebben, maar in linguïstische volgorde.

Hier is een voorbeeld van een gesorteerde lijst die is gemaakt met een Collator met de landinstellings-id 'en-US' (Engels in de VS) en de CollatorMode.MATCHING-optie:

Zoals hierboven is weergegeven, staan sommige tekens in linguïstische volgorde en worden deze behandeld alsof ze dezelfde tekenwaarde hebben.

Voor een nauwkeuriger beheer van de sorteervolgorde kunt u sorteereigenschappen zoals Collator.ignoreCase of Collator.ignoreDiacritics wijzigen.

Ter referentie geven we hier een bijbehorend sorteervoorbeeld, dat is uitgevoerd met de standaard Array.sort(), die niet landinstellingsafhankelijk is:

Zoals u hierboven kunt zien, worden alle tekens gewoon in de numerieke waardevolgorde van Unicode gesorteerd. Dit heeft linguïstisch gezien geen zin.

Om de huidige gebruikersinstellingen van het besturingssysteem te gebruiken, geeft u de statische waarde LocaleID.DEFAULT in de requestedLocaleIDName-parameter door aan de constructor.

Sommige landinstellingen hebben meerdere versies sorteervolgordes. In het Duits wordt bijvoorbeeld voor telefoonboeken een andere sorteervolgorde gebruikt dan voor woordenboeken. In het Chinees worden woorden doorgaans ondersteund door de transcriptie van de tekens in pinyin. Deze verschillende sorteervolgordes kunt u selecteren door het 'collatie'-trefwoord in te voegen in de tekenreeks die wordt doorgegeven aan de constructor in de requestedLocaleIDName-parameter.

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

Mogelijke waarden voor de sorteertekenreeks zijn als volgt, waarbij de beïnvloede talen tussen haakjes worden weergegeven.

Als het hostplatform geen ondersteuning biedt voor het aangevraagde sorteertype, wordt de fallback gebruikt en wordt de eigenschap lastOperationStatus ingesteld, zodat deze aangeeft dat er een fallback is geselecteerd. U kunt de actualLocaleIDName-eigenschap gebruiken om de waarde te bepalen die als een fallback is gebruikt, zoals wordt weergegeven in het volgende voorbeeld:

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

Wanneer de constructor met succes is uitgevoerd, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Wanneer de aangevraagde landinstellings-id niet beschikbaar is, wordt de lastOperationStatus-eigenschap op een van de volgende opties ingesteld:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

In het andere geval wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die in de LastOperationStatus-klasse worden gedefinieerd.

Meer informatie over de bovenstaande waarschuwingen en andere mogelijke waarden voor lastOperationStatus vindt u in de beschrijvingen in de klasse LastOperationStatus.

Verwante API-elementen

Vergelijkt twee tekenreeksen en retourneert een geheel getal dat aangeeft of de eerste tekenreeks korter, even lang of langer is dan de tweede tekenreeks. Bij de vergelijking wordt de sorteervolgorde gebruikt voor de landinstellings-id die is opgegeven in de Collator()-constructor.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Vergelijkt twee tekenreeksen en retourneert een Booleaanse waarde die aangeeft of beide tekenreeksen even lang zijn. Bij de vergelijking wordt de sorteervolgorde gebruikt voor de landinstellings-id die is opgegeven in de Collator()-constructor.

Wanneer deze methode wordt aangeroepen en met succes wordt voltooid, wordt de eigenschap lastOperationStatus ingesteld op:

• LastOperationStatus.NO_ERROR

Als dat niet het geval is, wordt de eigenschap lastOperationStatus ingesteld op een van de constanten die zijn gedefinieerd in de LastOperationStatus-klasse.

Parameters

Verwante API-elementen

Biedt een overzicht van alle namen van landinstellings-id's die door deze klasse worden ondersteund.

Als deze klasse helemaal niet wordt ondersteund op het huidige besturingssysteem, retourneert deze methode de waarde null.

1. Doorloopt een array van landinstellings-ID-namen, zoals de standaard landinstellings-ID voor het besturingssysteem (zoals bepaald door LocaleID.DEFAULT).
2. Maakt een Collator-object voor elke landinstellings-ID-naam met de 'sorteer'-modus (de standaardmodus).
3. Geeft de aangevraagde en werkelijke landinstellings-ID-namen weer en de waarde van de lastOperationStatus-eigenschap, zodat u kunt zien of de fallback-landinstelling werd gebruikt.
4. Sorteert een gegevensarray met elke collator en geeft het resultaat weer. De uiteindelijke volgorde is voor elke landinstelling verschillend.

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. Maakt een Collator-object voor de standaardlandinstelling van de gebruiker met de 'afstemmings'-modus.
2. De Collator.ignoreDiacritics-eigenschap stelt false of true in.
3. Vergelijkt tekenreekssets die diakritische tekens en hoofdletters en kleine letters bevatten.
4. Geeft weer hoe de vergelijkingen wijzigen, wanneer de Collator.ignoreDiacritics en Collator.ignoreCase-eigenschappen wijzigen.

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