Collator  - AS3

Der Name der Gebietsschema-ID, die von diesem Collator-Objekt verwendet wird.

Es drei Möglichkeiten für den Wert des Namens, abhängig vom Betriebssystem und dem Wert des requestedLocaleIDName-Parameters, der an den Collator()-Konstruktor übergeben wird.

1. Wenn das angeforderte Gebietsschema nicht LocaleID.DEFAULT war und das Betriebssystem das angeforderten Gebietsschema unterstützt, ist der zurückgegebene Name identisch mit der requestedLocaleIDName-Eigenschaft.
2. Wenn LocaleID.DEFAULT als Wert für den requestedLocaleIDName-Parameter an den Konstruktor übergeben wurde, wird der Name des aktuellen Gebietsschemas verwendet, der vom Betriebssystem des Benutzers angegeben wird. Der LocaleID.DEFAULT-Wert bewahrt die benutzerdefinierten Einstellungen im Betriebssystem. Mit der Übergabe eines expliziten Werts als requestedLocaleIDName-Parameter wird nicht unbedingt dasselbe Ergebnis erzielt wie mit der Verwendung von LocaleID.DEFAULT, selbst wenn die beiden Gebietsschema-ID-Namen identisch sind. Der Benutzer hat die Gebietsschemaeinstellungen auf seinem Computer möglicherweise angepasst. Wenn Sie einen expliziten Gebietsschema-ID-Namen anfordern, anstatt LocaleID.DEFAULT zu verwenden, erhält Ihre Anwendung diese benutzerdefinierten Einstellungen nicht.
3. Wenn das System den im Konstruktor angegebenen requestedLocaleIDName nicht unterstützt, wird ein Ersatzgebietsschema bereitgestellt.

Verwandte API-Elemente

Wenn diese Eigenschaft auf „true“ gesetzt ist, werden identische Strings und Strings, die sich nur in der Groß- und Kleinschreibung der Buchstaben unterscheiden, als gleich bewertet. Zum Beispiel gibt compare("ABC", "abc") den Wert true zurück, wenn die ignoreCase-Eigenschaft den Wert true hat.

Bei der Umwandlung von Groß- und Kleinbuchstaben werden die Regeln für das angegebene Gebietsschema beachtet.

Wenn die ignoreCase-Eigenschaft den Wert „false“ hat, werden Groß- und Kleinbuchstaben nicht als gleich angesehen.

Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Der Standardwert ist true, wenn für den zum Collator()-Konstruktor gehörenden initialMode-Parameter Collator.MATCHING festgelegt ist. Der Standardwert ist false, wenn für den zum Collator()-Konstruktor gehörenden initialMode-Parameter Collator.SORTING festgelegt ist.

Verwandte API-Elemente

Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Formen voller Breite und halber Breite bei bestimmten chinesischen und japanischen Zeichen als gleich bewertet.

Für die Kompatibilität mit vorhandenen Standards für chinesische und japanische Zeichensätze stellt Unicode Zeichencodes sowohl für Zeichen voller Breite als auch halber Breite bereit. Wenn zum Beispiel die ignoreCharacterWidth-Eigenschaft auf true gesetzt ist, gibt compare("Ａｱ", "Aア") den Wert true zurück.

Wenn die ignoreCharacterWidth-Eigenschaft auf false gesetzt ist, werden Zeichen voller Breite und halber Breite nicht als gleich angesehen.

Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Der Standardwert ist false.

Verwandte API-Elemente

Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Strings mit denselben Grundzeichen aber unterschiedlichen Akzenten oder anderen diakritischen Zeichen als gleich bewertet. Zum Beispiel gibt compare("coté", "côte") den Wert true zurück, wenn die ignoreDiacritics-Eigenschaft den Wert true hat.

Wenn die ignoreDiacritics-Eigenschaft den Wert false hat, werden Basiszeichen mit diakritischen Zeichen oder Akzenten nicht als gleich angesehen.

Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Der Standardwert ist false.

Verwandte API-Elemente

Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Strings, die sich nur durch die Art der verwendeten kana-Zeichen unterscheiden, als gleich bewertet. Zum Beispiel gibt compare("カナ", "かな") den Wert true zurück, wenn die ignoreKanaType-Eigenschaft den Wert true hat.

Wenn die ignoreKanaType-Eigenschaft auf false gesetzt ist, werden Hiragana- und Katakana-Zeichen, die sich auf dieselbe Silbe beziehen, nicht als gleich angesehen.

Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Der Standardwert ist false.

Verwandte API-Elemente

Wenn diese Eigenschaft auf „true“ gesetzt ist, werden Symbolzeichen wie Leerzeichen, Währungssymbole, mathematische Symbole und andere Arten von Symbolen beim Sortieren oder Überprüfen ignoriert. Zum Beispiel werden die Strings "OBrian", "O'Brian" und "O Brian" als gleich angesehen, wenn die ignoreSymbols-Eigenschaft den Wert true hat.

Wenn die ignoreSymbols-Eigenschaft den Wert „false“ hat, werden Symbolzeichen bei Stringvergleichen berücksichtigt.

Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Der Standardwert ist false.

Verwandte API-Elemente

Der Status der letzten Operation, die dieses Collator-Objekt ausgeführt hat. Die lastOperationStatus-Eigenschaft wird immer festgelegt, wenn der Konstruktor oder eine Methode dieser Klasse aufgerufen oder eine Eigenschaft festgelegt wird. Die möglichen Werte sind in der Beschreibung der einzelnen Methoden aufgeführt.

Verwandte API-Elemente

Regelt, wie numerische Werte, die in Strings eingebettet sind, bei Stringvergleichen behandelt werden.

Wenn die numericComparison-Eigenschaft den Wert true hat, konvertiert die Vergleichsmethode Zahlen, die im String vorkommen, zum Vergleich in numerische Werte.

Wenn diese Eigenschaft den Wert false hat, behandelt der Vergleich Zahlen als Zeichencodes und sortiert sie entsprechend der Regeln zum Sortieren von Zeichen im angegebenen Gebietsschema.

Wenn diese Eigenschaft zum Beispiel für das Gebietsschema "en-US" den Wert „true“ hat, werden die Strings "version1", "version10" und "version2" in dieser Reihenfolge sortiert: version1 < version2 < version10.

Wenn diese Eigenschaft für das Gebietsschema "en-US" den Wert „false“ hat, werden dieselben Strings in dieser Reihenfolge sortiert: version1 < version10 < version2.

Wenn dieser Eigenschaft ein Wert zugewiesen ist und es keine Fehler oder Warnungen gibt, wird die lastOperationStatus-Eigenschaft auf folgenden Wert gesetzt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Der Standardwert ist false.

Verwandte API-Elemente

Der Name der angeforderten Gebietsschema-ID, der an den Konstruktor dieses Collator-Objekts übergeben wurde.

Wenn der Wert LocaleID.DEFAULT verwendet wurde, lautet der zurückgegebene Name "i-default". Das tatsächlich verwendete Gebietsschema kann vom angeforderten Gebietsschema abweichen, wenn ein Ersatzgebietsschema verwendet wird. Der Name des tatsächlich verwendeten Gebietsschemas kann mit der actualLocaleIDName-Eigenschaft abgerufen werden.

Verwandte API-Elemente

Konstruiert ein neues Collator-Objekt, um Stringvergleiche entsprechend den Konventionen eines angegebenen Gebietsschemas bereitzustellen.

Wenn das aktuelle Betriebssystem die mit dem requestedLocaleIDName-Parameter übergegebene Gebietsschema-ID nicht unterstützt, wird ein Ersatzgebietsschema bestimmt. Wenn eine Ausweichlösung verwendet wird, gibt die lastOperationStatus-Eigenschaft den Typ der Ausweichlösung an.

Der initialMode-Parameter legt verschiedene Sortieroptionen für allgemeine Zwecke fest. Er kann auf einen der folgenden Werte eingestellt sein:

• CollatorMode.SORTING: legt Sortieroptionen für allgemeine linguistische Sortiervorgänge fest, zum Beispiel für das Sortieren einer Liste mit Textstrings, die einem Endbenutzer angezeigt werden. In diesem Modus werden Unterschiede in der Groß- und Kleinschreibung, Zeichen mit Akzent und andere gebietsschemaspezifische Unterschiede bei Stringvergleichen berücksichtigt.
• CollatorMode.MATCHING: legt Sortieroptionen für allgemeine Zwecke fest, zum Beispiel, um festzustellen, ob zwei Strings gleich sind. In diesem Modus werden Unterschiede in der Groß- und Kleinschreibung, Zeichen mit Akzent usw. bei Stringvergleichen nicht berücksichtigt.

Dies ist ein Beispiel für eine sortierte Liste, die mit einem Collator erstellt wurde, mit der Gebietsschema-ID „en-US“ (Englisch, USA) und der CollatorMode.SORTING-Option:

Wie oben gezeigt, werden alle Zeichen als unterschiedlich behandelt, aber in linguistischer Reihenfolge.

Dies ist ein Beispiel für eine sortierte Liste, die mit einem Collator erstellt wurde, mit der Gebietsschema-ID „en-US“ (Englisch, USA) und der CollatorMode.MATCHING-Option:

Wie oben gezeigt, stehen einige Zeichen in linguistisch korrekter Reihenfolge und werden wie gleiche Zeichenwerte behandelt.

Zur feineren Steuerung der Sortierreihenfolge können Sie Collator-Eigenschaften ändern, zum Beispiel Collator.ignoreCase oder Collator.ignoreDiacritics.

Zum Vergleich folgt ein entsprechendes Beispiel mit der Standardmethode Array.sort(), die das Gebietsschema nicht beachtet:

Wie Sie oben sehen können, sind alle Zeichen einfach in der Reihenfolge ihrer numerischen Unicode-Werte sortiert. Sprachlich ist dies nicht sinnvoll.

Um die Einstellungen des aktuellen Betriebssystems des Benutzers zu verwenden, übergeben Sie den statischen Wert LocaleID.DEFAULT im requestedLocaleIDName-Parameter an den Konstruktor.

Für einige Gebietsschemas gibt es verschiedene Sortiervarianten. Im Deutschen werden zum Beispiel für Telefonbücher und Wörterbücher unterschiedliche Sortierreihenfolgen verwendet. Im Chinesischen werden Wörter normalerweise durch Transkriptionen der Zeichen in Pinyin unterstützt. Diese unterschiedlichen Sortierreihenfolgen lassen sich auswählen, indem das Schlüsselwort "collation" in den String eingefügt wird, der im requestedLocaleIDName-Parameter an den Konstruktor übergeben wird.

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

Mögliche Werte für den collation-String sind nachstehend aufgeführt, mit der betroffenen Sprache in Klammern:

Wenn die Hostplattform den angeforderten Sortiertyp nicht unterstützt, wird eine Ausweichlösung verwendet und die lastOperationStatus-Eigenschaft gibt an, dass ein Ersatz ausgewählt wurde. Mit der actualLocaleIDName-Eigenschaft können Sie feststellen, welcher Wert als Ersatz verwendet wurde, wie im folgenden Beispiel gezeigt:

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

Wenn der Konstruktor erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft auf diesen Wert gesetzt:

• LastOperationStatus.NO_ERROR

Wenn die angeforderte Gebietsschema-ID nicht verfügbar ist, hat die lastOperationStatus-Eigenschaft einen der folgenden Werte:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Details zu den oben aufgeführten Warnungen und zu anderen möglichen Werten der lastOperationStatus-Eigenschaft finden Sie im Abschnitt zur LastOperationStatus-Klasse.

Verwandte API-Elemente

Vergleicht zwei Strings und gibt einen Ganzzahlwert zurück, der angibt, ob der erste String kleiner, gleich oder größer als der zweite String ist. Der Vergleich verwendet die Sortierregeln für die Gebietsschema-ID, die im Collator()-Konstruktor angegeben wurde.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Parameter

Verwandte API-Elemente

Vergleicht zwei Strings und gibt einen booleschen Wert zurück, der angibt, ob die Strings gleich sind. Der Vergleich verwendet die Sortierregeln für die Gebietsschema-ID, die im Collator()-Konstruktor angegeben wurde.

Wenn diese Methode aufgerufen und erfolgreich abgeschlossen wird, wird die lastOperationStatus-Eigenschaft folgendermaßen festgelegt:

• LastOperationStatus.NO_ERROR

Andernfalls wird die lastOperationStatus-Eigenschaft auf eine der Konstanten eingestellt, die in der LastOperationStatus-Klasse definiert sind.

Parameter

Verwandte API-Elemente

Listet alle Gebietsschema-ID-Namen auf, die von dieser Klasse unterstützt werden.

Wenn diese Klasse vom aktuellen Betriebssystem gar nicht unterstützt wird, gibt diese Methode einen Null-Wert zurück.

1. Durchläuft ein Array von Gebietsschema-ID-Namen einschließlich der Standardgebietsschema-ID für das Betriebssystem (wie von LocaleID.DEFAULT definiert)
2. Erstellt ein Collator-Objekt für jeden Gebietsschema-ID-Namen unter Verwendung des Modus „sorting“ (Standardeinstellung).
3. Zeigt die Namen der angeforderten und tatsächlichen Gebietsschema-IDs an sowie den Wert der lastOperationStatus-Eigenschaft, sodass Sie sehen können, ob ein Ersatzgebietsschema verwendet wurde.
4. Sortiert ein Datenarray unter Verwendung jedes Collators und zeigt die Ergebnisse an. Die resultierende Sortierung sieht für jedes Gebietsschema anders aus.

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. Erstellt ein Collator-Objekt für das Standardgebietsschema des Benutzers unter Verwendung des Modus „matching“.
2. Setzt die Collator.ignoreDiacritics-Eigenschaft abwechselnd auf false und true
3. Vergleicht Sätze von Strings, die diakritische Zeichen sowie Groß- und Kleinbuchstaben enthalten.
4. Zeigt, wie sich die Vergleiche ändern, wenn sich die Eigenschaften Collator.ignoreDiacritics und Collator.ignoreCase ändern.

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