Collator  - AS3

Bu Collator nesnesi tarafından kullanılan gerçek yerel ayar kimliğinin adı.

İşletim sistemine ve Collator() yapıcısına iletilen requestedLocaleIDName parametresinin değerine bağlı olarak, ad değeri için üç olasılık vardır.

1. İstenen yerel ayar LocaleID.DEFAULT değilse ve işletim sistemi, istenen yerel ayar için destek sağlıyorsa, döndürülen ad, requestedLocaleIDName özelliğiyle aynı olacaktır.
2. LocaleID.DEFAULT, yapıcıya requestedLocaleIDName parametresinin değeri olarak kullanıldıysa, kullanıcının işletim sistemi tarafından belirtilen geçerli yerel ayarın adı kullanılır. LocaleID.DEFAULT değeri, OS'de kullanıcının özelleştirilmiş ayarını saklar. requestedLocaleIDName parametresi olarak açık bir değerin iletilmesi, iki yerel ayar kimliği aynı olsa da, LocaleID.DEFAULT kullanılmasıyla aynı sonucu vermeyebilir. Kullanıcı makinesinde yerel ayarları özelleştirmiş olabilir ve LocaleID.DEFAULT öğesini kullanmak yerine açık yerel ayar kimlik adı isteyerek uygulamanız bu özelleştirilmiş ayarları almaz.
3. Sistem, yapıcıda belirtilen requestedLocaleIDName öğesini desteklemiyorsa, bir geri dönüş yerel ayarı kimlik adı sağlanır.

İlgili API Öğeleri

Bu özellik true değerine ayarlandığında, aynı dizeler ve yalnızca büyük küçük harf durumu farklı olan dizeler eşitmiş gibi değerlendirilir. Örneğin, ignoreCase özelliği true değerine ayarlandığında, compare("ABC", "abc") öğesi true değerini döndürür.

Dizenin büyük küçük harf dönüştürmesi, belirtilen yerel ayarın kurallarını izler.

ignoreCase özelliği false olduğunda, büyük ve küçük harfli karakterler birbirine eşit olmaz.

Bu özelliğe bir değer atandığında ve herhangi bir hata veya uyarı olmadığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Collator() oluşturucusunun initialMode parametresi Collator.MATCHING olarak ayarlandığında true varsayılan değerdir. Collator() oluşturucusunun initialMode parametresi Collator.SORTING olarak ayarlandığında false varsayılan değerdir.

İlgili API Öğeleri

Bu özellik true olduğunda, bazı Çince ve Japonca karakterlerin tam geniş ve yarım geniş formları, eşit olarak değerlendirilir.

Çince ve Japonca karakter kümelerinin varolan standartlarla uyumluluğu için, Unicode bazı karakterlerin hem tam geniş hem de yarım geniş formları için karakterler kodları sağlar. Örneğin, ignoreCharacterWidth özelliği true değerine ayarlandığında, compare("Ａｱ", "Aア"), true değerini döndürür.

ignoreCharacterWidth özelliği false değerine ayarlanırsa, tam geniş ve yarım geniş formlar birbirine eşit olmaz.

Bu özelliğe bir değer atandığında ve herhangi bir hata veya uyarı olmadığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Varsayılan değer şudur false.

İlgili API Öğeleri

Bu özellik true değerine ayarlandığında, aynı temel karakterleri ancak farklı aksan veya diğer ayırıcı işaretleri kullanan dizeler eşit olarak değerlendirilir. Örneğin, ignoreDiacritics özelliği true değerine ayarlandığında, compare("coté", "côte") öğesi true değerini döndürür.

ignoreDiacritics öğesi false değerine ayarlandığında, ayırıcı işaret veya aksan içeren temel karakterler birbirine eşit olmaz.

Bu özelliğe bir değer atandığında ve herhangi bir hata veya uyarı olmadığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Varsayılan değer şudur false.

İlgili API Öğeleri

Bu özellik true değerine ayarlandığında, yalnızca kullanılan kana karakterinin türüne göre farklılık gösteren dizeler eşit olarak değerlendirilir. Örneğin, ignoreKanaType özelliği true değerine ayarlandığında, compare(""カナ", "かな"") öğesi true değerini döndürür.

ignoreKanaType öğesi false değerine ayarlandığında, aynı heceye başvuran hiragana ve katakana karakterleri birbirine eşit olmaz.

Bu özelliğe bir değer atandığında ve herhangi bir hata veya uyarı olmadığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Varsayılan değer şudur false.

İlgili API Öğeleri

Bu özellik true değerine ayarlandığında, boşluk, para birimi sembolleri, matematik sembolleri gibi sembol karakterleri, sıralama veya eşleştirme yapılırken yok sayılır. Örneğin, ignoreSymbols özelliği true değerine ayarlandığında, "OBrian", "O'Brian" ve "O Brian" eşit olarak değerlendirilir.

ignoreSymbols özelliği false olursa, sembol karakterleri dize karşılaştırmalarında dikkate alınır.

Bu özelliğe bir değer atandığında ve herhangi bir hata veya uyarı olmadığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Varsayılan değer şudur false.

İlgili API Öğeleri

Bu Collater nesnesinin gerçekleştirdiği en son işlemin durumu. Bu sınıfın bir yapıcısı veya yöntemi her çağrıldığında ya da bir özellik ayarlandığında lastOperationStatus özelliği ayarlanır. Olası değerler için, her bir yöntemin altındaki açıklamaya bakın.

İlgili API Öğeleri

Dizelerde gömülü sayısal değerlerin, dize karşılaştırması sırasında nasıl işlendiğini denetler.

numericComparison özelliği true değerine ayarlandığında, compare yöntemi, dizelerde görüntülenen sayıları karşılaştırma için sayısal değerlere dönüştürür.

Bu özellik false değerine ayarlandıysa, karşılaştırmada sayılar karakter kodları olarak değerlendirilir ve belirtilen yerel ayardaki sıralama karakterlerinin kurallarına göre sıralanır.

Örneğin, bu özellik "tr-TR" yerel ayar kimliği için true olduğunda, "version1","version10" ve "version2" dizeleri şu şekilde sıralanır: version1 < version2 < version10.

Özellik "tr-TR" için false olduğunda, o dizeler şu şekilde sıralanır: version1 < version10 < version2.

Bu özelliğe bir değer atandığında ve herhangi bir hata veya uyarı olmadığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Varsayılan değer şudur false.

İlgili API Öğeleri

Bu Collator nesnesinin yapıcısına iletilmiş olan istenen yerel ayar kimliğinin adı.

LocaleID.DEFAULT değeri kullanıldıysa, döndürülen ad "i-default" olur. Geri dönüş yerel ayarı uygulandığında, gerçek yerel ayar, istenen yerel ayardan farklılık gösterebilir. Gerçek yerel ayarın adı, actualLocaleIDName özelliği kullanılarak alınabilir.

İlgili API Öğeleri

Belirtilen bir yerel ayarın kurallarına göre dize karşılaştırmaları sağlamak için yeni bir Collator nesnesi oluşturur.

Geçerli işletim sistemi, requestedLocaleIDName parametresinde iletilen yerel ayar kimliğini desteklemiyorsa, bir geri dönüş yerel ayarı belirlenir. Geri dönüş kullanılırsa, lastOperationStatus özelliği, geri dönüş türünü belirtmek için ayarlanır.

initialMode parametresi, genel kullanım için çeşitli harmanlama seçeneklerini ayarlar. Bu, aşağıdaki değerlerden birine ayarlanabilir:

• CollatorMode.SORTING: son kullanıcıya görüntülenecek metin dizeleri listesini sıralama gibi genel dilsel sıralama kullanımlarına yönelik harmanlama seçeneklerini ayarlar. Bu modda, büyük ve küçük harf, aksanlı karakterler ve yerel ayara özel diğer farklılıklar, dize karşılaştırmaları yapılırken dikkate alınır.
• CollatorMode.MATCHING: iki dizenin eşdeğer olup olmadığını belirleme gibi genel kullanıma yönelik harmanlama seçeneklerini ayarlar. Bu modda, büyük ve küçük harf, aksanlı karakterler, vb. farklılıklar, dize karşılaştırmaları yapılırken yok sayılır.

Aşağıda, "en-US" (ABD'de İngilizce) yerel ayar kimliği ve CollatorMode.SORTING seçeneğiyle Collator kullanılarak oluşturulmuş bir sıralanmış liste örneği bulunmaktadır:

Yukarıda gösterildiği gibi, tüm karakterler farklı değerlere sahipmiş gibi değerlendirilir ancak dilsel olarak sıralanır.

Aşağıda, "en-US" (ABD'de İngilizce) yerel ayar kimliği ve CollatorMode.MATCHING seçeneğiyle Collator kullanılarak oluşturulmuş bir sıralanmış liste örneği bulunmaktadır:

Yukarıda gösterildiği gibi, bazı karakterler dilsel olarak sıralanır ve aynı karakter değerlerine sahipmiş gibi değerlendirilir.

Sıralama düzeni üzerinde daha hassas denetim için, Collator.ignoreCase veya Collator.ignoreDiacritics gibi harmanlayıcı özelliklerini değiştirebilirsiniz.

Başvuru için, aşağıda, yerel ayara duyarlı olmayan standart Array.sort() öğesi kullanılarak yapılmış karşılık gelen bir sıralama örneği verilmiştir:

Yukarıda gördüğünüz gibi, tüm karakterler basitçe Unicode sayısal değeri sırasına göre sıralanır. Bu dilsel açıdan bir anlam ifade etmez.

Kullanıcının geçerli işletim sistemi tercihlerini kullanmak için, yapıcıya requestedLocaleIDName parametresinde LocaleID.DEFAULT statik değerini iletin.

Bazı yerel ayarların birçok sıralama düzeni varyantı vardır. Örneğin Almanca'da bir sıralama düzeni telefon defterleri için, farklı bir sıralama düzeni de sözlükler için kullanılır. Çince'de, kelimeler genellikle karakterlerin pinyine çevrilmesiyle desteklenir. Bu farklı sıralama düzenleri, yapıcıya requestedLocaleIDName parametresinde iletilen dizeye "collation" anahtar kelimesi eklenerek seçilebilir.

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

collation dizesine ilişkin olası değerler, etkilenen diller parantez içinde gösterilerek aşağıdaki gibidir.

Ana bilgisayar platformu istenen harmanlama türünü desteklemiyorsa, bir destek kullanılır ve lastOperationStatus özelliği bir desteğin seçildiğini belirtmek için ayarlanır. Bir destek olarak kullanılmış olan değeri belirlemek için aşağıdaki örnekte gösterildiği gibi actualLocaleIDName özelliğini kullanabilirsiniz.

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

Yapıcı başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

İstenen yerel ayar kimliği kullanılamıyorsa, lastOperationStatus öğesi şu değerlerden birine ayarlanır:

• LastOperationStatus.USING_FALLBACK_WARNING
• LastOperationStatus.USING_DEFAULT_WARNING

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Yukarıda listelenen uyarılar ve lastOperationStatus özelliğinin diğer olası değerleri hakkında ayrıntılı bilgi için, LastOperationStatus sınıfındaki açıklamalara bakın.

İlgili API Öğeleri

İki dizeyi karşılaştırır ve birinci dizenin, ikinci dizeden küçük mü, büyük mü, yoksa ikinci dizeye eşit mi olduğunu belirten bir tam sayı değeri döndürür. Karşılaştırmada, Collator() yapıcısında belirtilen yerel ayar kimliğinin sıralama düzeni kuralları kullanılır.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

İki dizeyi karşılaştırır ve dizelerin eşit olup olmadığını belirten bir Boolean değerini döndürür. Karşılaştırmada, Collator() yapıcısında belirtilen yerel ayar kimliğinin sıralama düzeni kuralları kullanılır.

Bu yöntem çağrıldığında ve başarıyla tamamlandığında, lastOperationStatus özelliği şu değere ayarlanır:

• LastOperationStatus.NO_ERROR

Aksi takdirde, lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

Bu sınıf tarafından desteklenen tüm yerel ayar kimlik adlarını listeler.

Bu sınıf geçerli işletim sisteminde desteklenmiyorsa, bu yöntem bir null değeri döndürür.

1. İşletim sisteminin varsayılan yerel ayar kimliğinin de dahil olduğu bir yerel ayar kimlik adları dizisinin içinden yineler (LocaleID.DEFAULT öğesi tarafından belirtildiği gibi)
2. "sorting" modunu (varsayılan) kullanarak her yerel ayar kimliği için birer Collator nesnesi oluşturur.
3. Bir geri dönüş yerel ayarının kullanılıp kullanılmadığını anlayabilmeniz için istenen ve asıl yerel ayar kimlik adlarını ve lastOperationStatus özelliğinin değerini görüntüler.
4. Harmanlayıcıların her birini kullanarak bir veri dizisi sıralar ve sonuçları görüntüler. Ortaya çıkan sıra her yerel ayar için farklıdır.

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. "matching" modunu kullanarak kullanıcının varsayılan yerel ayarı için bir Collator nesnesi oluşturur.
2. Alternatif olarak Collator.ignoreDiacritics özelliğini false ve true değerlerine ayarlar.
3. Ayırıcılar ve büyük harf ve küçük harf karakterleri içeren bir dizeler kümesini karşılaştırır.
4. Collator.ignoreDiacritics ve Collator.ignoreCase özellikleri değiştiğinde karşılaştırmaların ne şekilde değiştiğini gösterir.

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