CurrencyFormatter  - AS3

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

İşletim sistemine ve CurrencyFormatter() 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

Kullanılan gerçek yerel ayar için üç harfli ISO 4217 para birimi kodu.

Bu kod, para birimi sembolü veya dizesini belirlemek için withCurrencySymbol parametresi false değerine ayarlı şekilde format() yöntemi kullanılarak para birimi miktarları biçimlendirilirken kullanılır.

Bu özellik, kullanılan gerçek yerel ayara göre yapıcı tarafından başlatılır. Geri dönüş yerel ayarı kullanıldığında, bu özellik geri dönüş yerel ayarı için tercih edilen, varsayılan para birimi kodunu yansıtır.

Varsayılan değer şudur dependent on the actual locale and operating system.

İlgili API Öğeleri

Kullanılan gerçek yerel ayar için para birimi sembolü veya dizesi.

Bu özellik, withCurrencySymbol parametresi true değerine ayarlı şekilde format() yöntemi kullanılarak para birimi miktarları biçimlendirilirken para birimi sembolü olarak kullanılır.

Bu özellik, kullanılan gerçek yerel ayara göre yapıcı tarafından başlatılır. Geri dönüş yerel ayarı kullanıldığında, bu özellik geri dönüş yerel ayarı için tercih edilen, varsayılan para birimi sembolünü yansıtır.

Varsayılan değer şudur dependent on the actual locale and operating system.

İlgili API Öğeleri

Ondalık bölümü olan para birimi miktarlarının biçimlendirilmesi veya ayrıştırılması için kullanılan ondalık ayırıcı karakteri.

Bu özellik başlangıçta, biçimlendirici nesnesi oluşturulduğunda seçilen yerel ayara göre ayarlanı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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Para birimi miktarları biçimlendirilirken kullanılan basamak karakterleri kümesini tanımlar.

Farklı diller ve bölgeler, 0 ile 9 arasındaki basamakları temsil etmek için farklı karakterler kümesi kullanır. Bu özellik, kullanılacak basamak kümesini tanımlar.

Bu özelliğin değeri, ondalık basamak kümesinin sıfır basamağının Unicode değerini temsil eder. NationalDigitsType sınıfında bu özellik için geçerli değerler tanımlanmıştı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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Ondalık ayırıcıdan sonra görüntülenebilen maksimum basamak sayısı.

Sayılar, bu özellik tarafından belirtilen basamak sayısına yuvarlanır. Yuvarlama şeması, kullanıcının işletim sistemine göre değişir.

trailingZeros özelliği true olarak ayarlandığında, sayının kesir kısmı (ondalık işaretinden sonraki kısım), uzunluk bu fractionalDigits özelliğinin değeriyle aynı oluncaya kadar sıfırlarla doldurulur.

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 0.

İlgili API Öğeleri

Biçimlendirilen para birimi miktarı dizesindeki gruplandırma ayırıcılarının yerleşimini açıklar.

useGrouping özelliği true olarak ayarlanırsa, gruplandırma ayırıcısı için kullanılan yerleşimi ve deseni tanımlamak için groupingPattern özelliği kullanılır.

Gruplandırma deseni, noktalı virgüllerle ayrılmış sayıları içeren bir dize olarak tanımlanır ve isteğe bağlı olarak sonunda bir yıldız işareti bulunabilir. Örneğin, "3;2;*". Dizedeki sayıların her biri, bir gruptaki basamak sayısını temsil eder. Gruplandırma ayırıcı, her basamak grubunun önüne yerleştirilir. Dizenin sonundaki bir yıldız işareti, o basamak sayısına sahip grupların, biçimlendirilen dizenin geri kalanında yinelenmesi gerektiğini belirtir. Yıldız işareti yoksa, biçimlendirilen dizenin geri kalanı için ek bir grup veya ayırıcı olmayacaktır.

Dizedeki ilk sayı, ondalık ayırıcının solundaki ilk basamak grubuna karşılık gelir. Sonraki sayılar, soldaki sonraki gruplarda bulunan basamak sayısını tanımlar. Bu nedenle de, "3;2;*" dizesi, ilk 3 basamaklık gruptan sonra bir gruplandırma ayırıcının yerleştirildiğini ve bundan sonra da 2 basamaklık grubun geldiğini belirtir. Örneğin: 98,76,54,321

Aşağıdaki tabloda, 123456789.12 para birimi miktarının çeşitli gruplandırma desenleriyle biçimlendirilmesinin örnekleri gösterilmektedir. Gruplandırma ayırıcı virgül, ondalık ayırıcı nokta ve para birimi sembolü de dolar işaretidir ($).

Yalnızca sınırlı sayıda gruplandırma boyutu tanımlanabilir. Bazı işletim sistemlerinde, gruplandırma desenleri yalnızca iki sayı ve bir yıldız işareti içerebilir. Diğer işletim sistemleriyse, dörde kadar sayıyı ve bir yıldız işaretini destekleyebilir. Yıldız işareti bulunmayan desenler için, bazı işletim sistemleri yalnızca bir sayıyı desteklerken, diğerleri üçe kadar sayıyı destekler. Maksimum gruplandırma deseni öğesi sayısı aşılırsa, ek öğeler yok sayılır ve lastOperationStatus özelliği aşağıdaki gibi açıklanı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.

İlgili API Öğeleri

Gruplandırma ayırıcı için kullanılan karakter veya dize.

useGrouping özelliği true olduğunda, bu özelliğin değeri, para birimi miktarları biçimlendirilirken gruplandırma ayırıcı olarak kullanılır. Bu özellik başlangıçta, biçimlendirici nesnesi oluşturulduğunda seçilen yerel ayara göre ayarlanı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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Bu CurrencyFormatter 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 başka bir özellik ayarlandığında lastOperationStatus özelliği ayarlanır. Olası değerler için, her bir yöntemin açıklamasına bakın.

İlgili API Öğeleri

Ondalık ayırıcının solunda bir tam sayı basamağı olmadığında, biçimlendirilen para birimi miktarının başına sıfır sayısının eklenip eklenmeyeceğini belirtir.

Bu özellik true değerine ayarlandığında, -1.0 ile 1.0 arasındaki sayısal değerler biçimlendirilirken ondalık ayırıcının soluna sıfır eklenir. Bu özellik false değerine ayarlandığında, başa sıfır eklenmez.

Örneğin, para birimi miktarı 0.321 ise ve bu özellik true değerine ayarlandıysa, biçimlendirilen dizenin başına sıfır eklenir. Özellik false değerine ayarlandıysa, başa sıfır eklenmez. Bu durumda, dizede yalnızca ondalık ayırıcı bulunur ve ardından ondalık basamaklar gelir, örn. $.321.

Aşağıdaki tabloda, bu özelliğin ve ilgili fractionalDigits ile trailingZeros özelliklerinin değerlerine göre para birimi miktarlarının nasıl biçimlendirildiğine dair örnekler gösterilmektedir.

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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Negatif para birimi miktarları için biçimlendirme desenini belirten sayısal bir değer. Bu desen, para birimi miktarının sayısal kısmına göre para birimi sembolünün ve negatif sembolünün veya parantezlerin konumunu tanımlar.

Bu özelliğin değeri, aşağıdaki tabloda açıklanan sabitlerden biri olmalıdır.

Aşağıdaki tablo negatif para birimi miktarları için olası biçimlendirme desenlerini özetler. Bir para birimi miktarı, format() yöntemiyle biçimlendirildiğinde:

• format() yöntemine iletilen withCurrencySymbol parametresinin değerine bağlı olarak, '¤' sembolünün yerine currencyISOCode veya currencySymbol özelliğinin değeri gelir;
• '-' karakterinin yerine, negativeNumberSymbol özelliğinin değeri gelir;
• 'n' karakterinin yerine, format() yöntemine iletilen para birimi miktarının değeri gelir.

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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Negatif para birimi miktarlarını biçimlendirirken kullanılan negatif sembolü.

Bu sembol, sıfırdan küçük bir para birimi biçimlendirilirken negatif para birimi biçimiyle birlikte kullanılır. Negatif işareti içermeyen negatif para birimi biçimlerinde (örn. negatif para birimi miktarları parantez içine alındığında) kullanılmaz.

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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Pozitif para birimi miktarları için biçimlendirme desenini belirten sayısal bir değer. Bu biçim, para birimi miktarının sayısal kısmına göre para birimi sembolünün konumunu tanımlar.

Bu özelliğin değeri, aşağıdaki tabloda açıklanan sabitlerden biri olmalıdır.

Aşağıdaki tablo pozitif para birimi miktarları için olası biçimlendirme desenlerini özetler. Bir para birimi miktarı, format() yöntemiyle biçimlendirildiğinde:

• format() yöntemine iletilen withCurrencySymbol parametresinin değerine bağlı olarak, '¤' sembolünün yerine currencyISOCode veya currencySymbol özelliğinin değeri gelir;
• 'n' karakterinin yerine, format() yöntemine iletilen para birimi miktarının değeri gelir.

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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Bu CurrencyFormatter 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

Sondaki sıfırların biçimlendirilen para birimi miktarına dahil edilip edilmeyeceğini belirtir.

Bu özellik true değerine ayarlandığında, sondaki sıfırlar, fractionalDigits özelliğinin belirttiği sınıra kadar, biçimlendirilen sayının kesir kısmına dahil edilecektir. Bu özellik false değerine ayarlandığında, sondaki sıfırlar gösterilmez.

Örneğin, para birimi miktarı 123.4 olursa ve bu özellik true değerine ve fractionalDigits özelliği de 3 değerine ayarlandıysa, biçimlendirilen dize sondaki sıfırları gösterir, örn. $123.400. Bu özellik false olursa, sondaki sıfırlar dahil edilmez ve dizede yalnızca ondalık ayırıcı ve onun ardından sıfırlar olmadan ondalık basamaklar gösterilir, örn. $123.4 .

Aşağıdaki tabloda, bu özelliğin ve ilgili fractionalDigits ve leadingZero özelliklerinin değerlerine göre para birimi miktarlarının nasıl biçimlendirildiğine dair örnekler gösterilmektedir.

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 dependent on the actual locale and operating system.

İlgili API Öğeleri

Para birimi miktarları biçimlendirilirken gruplandırma ayırıcısının kullanılmasına olanak sağlar.

useGrouping özelliği true değerine ayarlandığında, basamaklar gruplandırılır ve ayırıcı karakteriyle ayrılır. Örneğin: $123,456,789

useGrouping özelliği false değerine ayarlandığında, basamaklar gruplandırılmaz veya ayrılmaz. Örneğin: $123456789

groupingSeparator özelliği, gruplama ayırıcısı olarak kullanılacak sembolü tanımlar. groupingPattern özelliği, gruplama ayrıcıları arasındaki rakam sayısını tanımlar.

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.

İlgili API Öğeleri

Belirli bir yerel ayarın kurallarına göre para birimi miktarlarını temsil eden sayıları biçimlendirmek için yeni bir CurrencyFormatter nesnesi oluşturur.

Bu yapıcı, geçerli işletim sisteminin istenen yerel ayar kimliği adını destekleyip desteklemediğini belirler. Desteklenmiyorsa, bunun yerine geri dönüş yerel ayarı kullanılır. Bir geri dönüş yerel ayarı kullanılırsa, lastOperationStatus özelliği geri dönüş türünü belirtir ve actualLocaleIDName özelliği, geri dönüş yerel ayar kimliğinin adını içerir.

currencySymbol ve currencyISOCode gibi belirli özellikler, yerel ayara göre otomatik olarak ayarlanır.

NOT: Bir geri dönüş yerel ayarı kullanıldığında, para birimi özellikleri varsayılan değerlere ayarlanır ve bundan dolayı, currencySymbol veya currencyISOCode özelliklerine beklenmeyen değerler verilebilir. Bir para birimi miktarını biçimlendirmeden önce, currencySymbol ve currencyISOCode özellik değerlerini incelemek iyi bir fikirdir.

Kullanıcının geçerli işletim sistemi tercihlerine bağlı olarak biçimlendirmek için, yapıcıya requestedLocaleIDName parametresinde LocaleID.DEFAULT değerini iletin.

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

• LastOperationStatus.NO_ERROR

İstenen yerel ayar kimlik adı 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

Bu CurrencyFormatter nesnesinin mevcut özelliklerine dayanarak biçimlendirilen bir para birimi miktarını temsil eden bir dize oluşturur; buna yerel ayar, para birimi sembolü ve para birimi ISO kodu dahildir.

Varsayılan olarak bu yöntem, biçimlendirme sırasında kullanılan para birimi sembolünü ve diğer ayarları belirlemek için currencyISOCode özelliğini kullanır.

Çoğu ülke ve bölge, farklı para birimleri için aynı para birimi sembollerini kullanır. Örneğin, ABD, Avustralya, Yeni Zelanda, Kanada ve Meksika ülkelerinin tümü, yerel para birimi değerleri için aynı dolar işareti sembolünü ($) kullanır. Biçimlendirme para birimi kullanıcının yerel para biriminden farklı olduğunda yapılacak en iyi şey ISO kodunu para birimi dizesi olarak kullanmaktır. Para biriminin biçimlendirilmesi gereken ISO kodunun biçimlendiricinin currencyISOCode özelliğiyle eşleşip eşleşmediğini test etmek için formattingWithCurrencySymbolIsSafe() yöntemini kullanabilirsiniz.

Bu yöntem, çok büyük ve çok küçük sayıları biçimlendirebilir. Ancak, önemli basamakların sayısı, Number veri türünün sağladığı kesinlikle sınırlıdır

Parametreler

İlgili API Öğeleri

 
         var cf:CurrencyFormatter = new CurrencyFormatter("fr-CA");  
         
         trace(cf.actualLocaleIDName);               // "fr-CA"  
         trace(cf.currencyISOCode);                // "CAD"
         trace(cf.currencySymbol);                // "$"
         
         trace(cf.format(1254.56));                // "1 254,56 CAD"
         trace(cf.format(1254.56, true));            // "1 254,56 $"
         

 
         var cf:CurrencyFormatter = new CurrencyFormatter(LocaleID.DEFAULT);  
         
         if (cf.formattingWithCurrencySymbolIsSafe("CAD")) {
           trace(cf.actualLocaleIDName);     // "fr-CA French (Canada)"
           trace(cf.format(1254.56, false)); // "1 254,56 $"
         }
         else {
           trace(cf.actualLocaleIDName);     // "en-US English (USA)"
           cf.setCurrency("CAD", "C$")
           trace(cf.format(1254.56, true));  // "C$ 1,254.56"
         }
         

O sırada belirlenen para birimi sembolünün, para birimi miktarları biçimlendirilirken kullanılıp kullanılamayacağını belirler.

Çoğu bölge ve ülke aynı para birimi sembollerini kullanır. Karmaşık bir para birimi sembolünün veya geri dönüş yerel ayarının kullanılması nedeniyle beklenenden farklı bir para birimi sembolünün ya da ISO kodunun kullanılmasına karşı koruma oluşturmak için bu yöntem kullanılabilir.

Bu yöntemin yaygın bir kullanımı, yerel para birimi sembolünün mü (miktar kullanıcının varsayılan para biriminde biçimlendirilecekse) yoksa daha belirgin bir ISO kodu dizesinin mi (miktar kullanıcının varsayılanından farklı bir para biriminde biçimlendirilecekse) gösterileceğini belirlemektir.

Bu yöntem, requestedISOCode parametresini geçerli currencyISOCode özelliğiyle karşılaştırır ve dizeler eşitse true değerini, değilse false değerini döndürür. Dizeler eşitse, withCurrencySymbol parametresi true değerine ayarlı şekilde format() yönteminin kullanılması, yerel ayarın benzersiz para birimi sembolünü içeren biçimlendirilmiş bir değer dizesi sonucunu verir. Bu yöntem false değerini döndürürse, withCurrencySymbol parametresi true değerine ayarlı şekilde format() yönteminin kullanılması, karmaşık veya yanlış bir para birimi sembolünün kullanılmasıyla sonuçlanabilir.

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 null değerini döndürü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.

Bir dizeyi, para birimi miktarına ve para birimi sembolüne ayrıştırır.

Ayrıştırma algoritması, sayının integral ve kesir kısmını belirlemek için decimalSeparator özelliğinin değerini kullanır. Para birimi miktarına göre para birimi sembolünün veya dizesinin konumunu belirlemek için, negativeCurrencyFormat ve positiveCurrencyFormat özelliklerinin değerlerini kullanır. Negatif miktarlar için, negatif sembolünün konumunu ve parantez kullanılıp kullanılmayacağını negativeCurrencyFormat özelliğinin değeri belirler.

Girdi dizesindeki para birimi sembolü, eksi işareti ve sayı, negativeCurrencyFormat ve positiveCurrencyFormat özellikleri tarafından tanımlanan desenle eşleşmiyorsa:

1. Döndürülen CurrencyParseResult nesnesinin value özelliği NaN değerine ayarlanır.
2. Döndürülen CurrencyParseResult nesnesinin currencyString özelliği null değerine ayarlanır.
3. lastOperationStatus özelliği, ayrıştırmanın başarısız olduğunu belirtecek şekilde ayarlanır.

Girdi dizesi, ayrıştırma sırasında yok sayılacak boşluk karakterlerini içerebilir.

Para birimi sembolü olmasa da ayrıştırma başarılı olabilir. Dizenin, para birimi sembolüne karşılık gelen kısmı için bir doğrulama yapılmaz. Bir para birimi sembolü veya dizesi yoksa, döndürülen CurrencyParseResult nesnesindeki currencyString özelliği boş bir dizeye ayarlanı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

CurrencyFormatter nesnesinin currencyISOCode ve currencySymbol özelliklerini ayarlar.

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, currencyISOCode ve currencySymbol özellikleri değiştirilmez ve lastOperationStatus özelliği, LastOperationStatus sınıfında tanımlanan sabitlerden birine ayarlanır.

Parametreler

İlgili API Öğeleri

Bu örnek aşağıdaki yerel ayarları kullanır:

• Para birimi biçimlendirmeye ilişkin varsayılan işletim sistemi yerel ayarı (LocaleID.DEFAULT)
• Japonca (Japonya)
• İngilizce (ABD)
• Fransızca (Fransa)

Aşağıdaki örnek listedeki her yerel ayar için aşağıdakileri yapar:

1. Bir CurrencyFormatter nesnesi oluşturur
2. Yerel ayara ilişkin varsayılan para biriminin Euro ("EUR") olup olmadığını kontrol etmek için formattingWithCurrencySymbolIsSafe() yöntemini kullanın ve bu sayede o, dizeyi para birimi sembolünü kullanarak biçimlendirir. Yoksa, dizeyi ISO kodunu kullanarak biçimlendirir.

  
package {
    import flash.display.Sprite;
    import flash.globalization.CurrencyFormatter;
    import flash.globalization.LocaleID;
    
    public class CurrencyFormatterExample1 extends Sprite
    {
        public function CurrencyFormatterExample1():void
        {
            var cf:CurrencyFormatter;
            var amountWithSymbol:String;
            var amountWithISOCode:String
            
            var localeNames:Array = [LocaleID.DEFAULT, "ja-JP", "en-US", "fr-FR"];
            
            for each (var localeName:String in localeNames) 
            {
                cf = new CurrencyFormatter(localeName);
                
                trace('\n' + "LocaleID requested=" + cf.requestedLocaleIDName 
                    + "; actual=" + cf.actualLocaleIDName);
                
                trace("Last Operation Status: " + cf.lastOperationStatus );
                
                trace("Currency ISO Code: " + cf.currencyISOCode);
                
                if (cf.formattingWithCurrencySymbolIsSafe("EUR")) 
                {
                    amountWithSymbol = cf.format(123456789.19, true);
                    trace("Format using Symbol: "+ amountWithSymbol);
                }
                else 
                {
                    amountWithISOCode = cf.format(123456789.19); 
                    trace("Format using ISO Code: " + amountWithISOCode);
                }
            }
        }
    }
}

Bu örnek aşağıdaki adımları izler:

1. İngilizce (ABD) yerel ayarı için bir CurrencyFormatter nesnesi oluşturur.
2. Giriş dizesini ayrıştırmak için parse() yöntemini kullanır.
3. Ortaya çıkan CurrencyParseResult nesnesindeki miktar ve para birimi dizesi değerlerini görüntüler.

 
package {
      import flash.display.Sprite;
      import flash.globalization.CurrencyFormatter;
      import flash.globalization.CurrencyParseResult;
      import flash.globalization.LastOperationStatus;
      import flash.globalization.LocaleID;

      public class CurrencyFormatterParseExample extends Sprite
      {
            public function CurrencyFormatterParseExample()
            {
                var cf:CurrencyFormatter = new CurrencyFormatter( "en_US" );
                
                trace("LocaleID requested=" + cf.requestedLocaleIDName 
                    + "; actual=" + cf.actualLocaleIDName);
                trace("Last Operation Status: " + cf.lastOperationStatus );

                var inputString:String = "Dollar 123,567,89,0.254";
                
                var result:CurrencyParseResult = cf.parse(inputString);
                
                if (cf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
                    trace("Amount value: " + result.value); 
                    trace("Currency string: " + result.currencyString); 
                }
            }
      }
}