Collator  - AS3

Il nome dell'ID di impostazioni internazionali effettivamente utilizzato da questo oggetto Collator.

Esistono tre possibilità per il nome del valore, a seconda del sistema operativo e del valore del parametro requestedLocaleIDName passato alla funzione di costruzione Collator().

1. Se le impostazioni internazionali richieste non corrispondevano al valore LocaleID.DEFAULT e il sistema operativo fornisce il supporto per tali impostazioni internazionali, il nome restituito corrisponde alla proprietà requestedLocaleIDName.
2. Se è stato utilizzato LocaleID.DEFAULT come valore del parametro requestedLocaleIDName passato alla funzione di costruzione, viene utilizzato il nome delle impostazioni internazionali correnti specificato dal sistema operativo dell'utente. Il valore LocaleID.DEFAULT mantiene l'impostazione personalizzata dell'utente nel sistema operativo. Se passate un valore esplicito come parametro requestedLocaleIDName, non viene necessariamente restituito lo stesso risultato fornito da LocaleID.DEFAULT, anche se i nomi dei due ID di impostazioni internazionali sono gli stessi. L'utente potrebbe avere personalizzato le impostazioni internazionali del computer e la richiesta di un nome esplicito dell'ID di impostazioni internazionali, anziché l'utilizzo di LocaleID.DEFAULT, può impedire all'applicazione di rilevare tali impostazioni personalizzate.
3. Se il sistema operativo non supporta il parametro requestedLocaleIDName specificato nella funzione di costruzione, viene fornito un nome dell'ID di impostazioni internazionali di riserva.

Elementi API correlati

Quando questa proprietà è impostata su true, le stringhe identiche e quelle che differiscono solo per l'uso delle maiuscole e minuscole vengono considerate uguali. Ad esempio, compare("ABC", "abc") restituisce true quando la proprietà ignoreCase è impostata su true.

La conversione di maiuscole/minuscole della stringa segue le regole delle impostazioni internazionali specificate.

Quando la proprietà ignoreCase è false, i caratteri maiuscoli e maiuscoli non vengono considerati uguali.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è true quando il parametro initialMode della funzione di costruzione Collator() è impostato su Collator.MATCHING. Il valore predefinito è false quando il parametro initialMode della funzione di costruzione Collator() è impostato su Collator.SORTING.

Elementi API correlati

Quando questa proprietà è true, le forme a larghezza intera e a mezza larghezza di alcuni caratteri cinesi e giapponesi vengono considerate uguali.

Ai fini della compatibilità con gli standard esistenti per i set di caratteri cinesi e giapponesi, per alcuni caratteri Unicode fornisce codici di caratteri sia per le forme a larghezza intera che a mezza larghezza. Quando ad esempio la proprietà ignoreCharacterWidth è impostata su true, compare("Ａｱ", "Aア") restituisce true.

Se la proprietà ignoreCharacterWidth è impostata su false, le forme a larghezza intera e a mezza larghezza non vengono considerate uguali.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è false.

Elementi API correlati

Quando questa proprietà è impostata su true, le stringhe che usano gli stessi caratteri base ma accenti o altri segni diacritici differenti vengono considerate uguali. Ad esempio, compare("coté", "côte") restituisce true quando la proprietà ignoreDiacritics è impostata su true.

Quando la proprietà ignoreDiacritics è impostata su false, i caratteri base con segni diacritici o accenti non vengono considerati uguali.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è false.

Elementi API correlati

Quando questa proprietà è impostata su true, le stringhe che differiscono solo per il tipo di carattere kana utilizzato vengono considerate uguali. Ad esempio, compare("カナ", "かな") restituisce true quando la proprietà ignoreKanaType è impostata su true.

Se ignoreKanaType è impostata su false, i caratteri hiragana e katakana che fanno riferimento alla stessa sillaba non vengono considerati uguali.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è false.

Elementi API correlati

Quando questa proprietà è impostata su true, i caratteri di simboli quali spazi, simboli di valute, simboli matematici e altri tipi di simboli vengono ignorati ai fini dell'ordinamento o della corrispondenza. Le stringhe "OBrian", "O'Brian" e "O Brian", ad esempio, vengono considerate uguali quando la proprietà ignoreSymbols è impostata su true.

Se la proprietà ignoreSymbols è false, i caratteri di simboli vengono considerati nei confronti tra stringhe.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è false.

Elementi API correlati

Lo stato dell'operazione più recente eseguita da questo oggetto Collator. La proprietà lastOperationStatus viene impostata ogni volta che chiamate una funzione di costruzione o un metodo di questa classe oppure impostate un'altra proprietà. Per i valori possibili, fate riferimento alla descrizione dei singoli metodi.

Elementi API correlati

Controlla come vengono gestiti i valori numerici incorporati nelle stringhe durante un confronto tra stringhe.

Quando la proprietà numericComparison è impostata su true, il metodo compare converte i numeri visualizzati nelle stringhe in valori numerici ai fini del confronto.

Quando questa proprietà è impostata su false, i numeri vengono trattati come codici di caratteri nel confronto e ordinati in base alle regole per l'ordinamento dei caratteri nelle impostazioni internazionali specificate.

Quando, ad esempio, questa proprietà è true per l'ID di impostazioni internazionali "en-US", le stringhe "version1", "version10" e "version2" vengono ordinate come version1 < version2 < version10.

Quando questa proprietà è false per "en-US", le stesse stringhe vengono ordinate come version1 < version10 < version2.

Quando a questa proprietà viene assegnato un valore e non sono presenti errori o avvisi, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Il valore predefinito è false.

Elementi API correlati

Il nome dell'ID di impostazioni internazionali richiesto che è stato passato alla funzione di costruzione di questo oggetto Collator.

Se è stato utilizzato il valore LocaleID.DEFAULT, il nome restituito è "i-default". Quando vengono applicate impostazioni internazionali di riserva, le impostazioni internazionali effettivamente utilizzate possono essere diverse da quelle richieste. Il nome delle impostazioni internazionali effettive può essere recuperato utilizzando la proprietà actualLocaleIDName.

Elementi API correlati

Crea un nuovo oggetto Collator per fornire confronti di stringa in base alle convenzioni di un determinato contesto di impostazioni internazionali.

Se il sistema operativo corrente non supporta l'ID di impostazioni internazionali passato nel parametro requestedLocaleIDName, vengono determinate le impostazioni internazionali di riserva. Se vengono utilizzate le impostazioni internazionali di riserva, la proprietà lastOperationStatus deve essere impostata per indicare il tipo di riserva.

Il parametro initialMode consente di impostare varie opzioni di confronto per usi generici. Può assumere uno dei seguenti valori:

• CollatorMode.SORTING: consente di impostare opzioni di confronto per usi comuni di ordinamento linguistico, ad esempio l'ordinamento di un elenco di stringhe di testo che viene visualizzato all'utente finale. In questa modalità, le differenze tra lettere maiuscole e minuscole, caratteri accentati e altre differenze specifiche delle impostazioni internazionali vengono prese in considerazione durante l'esecuzione dei confronti di stringa.
• CollatorMode.MATCHING: consente di impostare opzioni di confronto per usi comuni, ad esempio determinare se due stringe sono equivalenti. In questa modalità, le differenze tra lettere maiuscole e minuscole, caratteri accentati e così via vengono ignorate durante l'esecuzione dei confronti di stringa.

Di seguito è riportato un esempio di elenco ordinato creato tramite un oggetto Collator con l'ID di impostazioni internazionali "en-US" (inglese, Stati Uniti) e l'opzione CollatorMode.SORTING:

Come illustrato sopra, tutti i caratteri vengono trattati come se avessero valori diversi, ma in ordine linguistico.

Di seguito è riportato un esempio di elenco ordinato creato tramite un oggetto Collator con l'ID di impostazioni internazionali "en-US" (inglese, Stati Uniti) e l'opzione CollatorMode.MATCHING:

Come illustrato sopra, alcuni caratteri sono ordinati linguisticamente e vengono trattati come se avessero lo stesso valore di carattere.

Per un controllo più rigoroso dell'ordinamento, potete modificare le proprietà di confronto, ad esempio Collator.ignoreCase o Collator.ignoreDiacritics.

Come riferimento, di seguito è riportato un esempio di ordinamento corrispondente, eseguito con il metodo standard Array.sort(), che non riconosce le impostazioni internazionali:

Come potete vedere, tutti i caratteri sono elencati semplicemente nell'ordine di valore numerico Unicode. Dal punto di vista linguistico, non ha molta rilevanza.

Per utilizzare le preferenze del sistema operativo corrente dell'utente, passate alla funzione di costruzione il valore statico LocaleID.DEFAULT nel parametro requestedLocaleIDName.

Alcune impostazioni internazionali presentano diverse varianti di ordinamento. In tedesco, ad esempio, viene utilizzato un tipo di ordinamento per le guide telefoniche e un altro per i dizionari. In cinese le parole sono comunemente supportate mediante la traslitterazione dei caratteri in pinyin. Potete selezionare questi diversi tipi di ordinamento includendo la parola chiave "collation" nella stringa passata nel parametro requestedLocaleIDName alla funzione di costruzione.

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

Di seguito sono elencati i valori possibili per la stringa di confronto; le lingue interessate sono racchiuse tra parentesi:

Se il tipo di confronto richiesto non è supportato dalla piattaforma host, viene utilizzato un tipo di riserva e la proprietà lastOperationStatus viene impostata in modo da indicare che è stato selezionato un tipo di riserva. Potete utilizzare la proprietà actualLocaleIDName per determinare il valore di riserva che è stato utilizzato, come nell'esempio seguente:

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

Quando la funzione di costruzione viene completata correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Quando l'ID di impostazioni internazionali richiesto non è disponibile, lastOperationStatus è impostata su uno dei valori seguenti:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Per informazioni dettagliate sugli avvisi sopra indicati e altri possibili valori della proprietà lastOperationStatus, fate riferimento alle descrizioni disponibili nella classe LastOperationStatus.

Elementi API correlati

Confronta due stringhe e restituisce un valore intero che indica se la prima stringa è inferiore, uguale o superiore alla seconda stringa. Nel confronto vengono utilizzate le regole di ordinamento per l'ID di impostazioni internazionali specificato nella funzione di costruzione Collator().

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Confronta due stringhe e restituisce un valore booleano che indica se le stringhe sono uguali. Nel confronto vengono utilizzate le regole di ordinamento per l'ID di impostazioni internazionali specificato nella funzione di costruzione Collator().

Quando questo metodo viene chiamato e completato correttamente, la proprietà lastOperationStatus viene impostata su:

• LastOperationStatus.NO_ERROR

Diversamente, la proprietà lastOperationStatus viene impostata su una delle costanti definite nella classe LastOperationStatus.

Parametri

Elementi API correlati

Elenca tutti i nomi degli ID di impostazioni internazionali supportati da questa classe.

Se questa classe non è supportata dal sistema operativo corrente, il metodo restituisce un valore null.

1. Esegue un'iterazione su un array di nomi degli ID di impostazioni internazionali, incluso quello predefinito del sistema operativo (secondo quanto specificato da LocaleID.DEFAULT)
2. Crea un oggetto Collator per ogni nome dell'ID di impostazioni internazionali utilizzando la modalità predefinita "sorting".
3. Visualizza i nomi degli ID di impostazioni internazionali richiesti ed effettivi e il valore della proprietà lastOperationStatus, in modo da verificare se sono state usate impostazioni internazionali di riserva.
4. Ordina un array di dati utilizzando ogni Collator e visualizza i risultati. L'ordine risultante è diverso per ogni contesto di impostazioni internazionali.

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. Crea un oggetto Collator per le impostazioni internazionali predefinite dell'utente utilizzando la modalità "matching".
2. In alternativa, imposta la proprietà Collator.ignoreDiacritics su false e true
3. Confronta i gruppi di stringhe contenenti segni diacritici e caratteri maiuscoli/minuscoli.
4. Mostra come vengono modificati i confronti quando cambiano le proprietà Collator.ignoreDiacritics e Collator.ignoreCase.

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