| Paket | flash.globalization |
| Sınıf | public final class NumberFormatter |
| Miras Alma | NumberFormatter Object |
| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
int, uint ve Number nesnelerini biçimlendirebilir.
NumberFormatter sınıfı, işletim sistemi tarafından sağlanan veri ve işlevleri kullanır ve kullanıcının tercihleri ve kullanıcının işletim sistemi tarafından desteklenen özellikler temel alınarak belirli bir yerel ayarın kurallarına göre sayıları biçimlendirmek için bu sınıf atanır. Sayı biçimindeki negatif sembolün, ondalık ayırıcının, gruplandırma ayırıcının, gruplandırma deseninin ve diğer öğelerin konumu, yerel ayara bağlı olarak değişiklik gösterebilir.
İşletim sistemi istenilen yerel ayarı destekliyorsa, sayı biçimlendirme özellikleri, istenilen yerel ayarın kurallarına ve varsayılan ayarlarına göre ayarlanır. İstenen yerel ayar kullanılamıyorsa, özellikler, actualLocaleIDName özelliği kullanılarak alınabilen bir geri dönüş veya varsayılan sistem yerel ayarına göre ayarlanır.
Kullanıcının ayarları kullanıldığından, işletim sisteminin sağladığı biçimlendirme desenlerinin kullanımı ve istenen bir yerel ayar desteklenmediğinde geri dönüş yerel ayarının kullanımı desteklenmez, farklı kullanıcılar aynı yerel ayar kimliğini kullansa da, farklı biçimlendirme sonuçları görebilir.
| Özellik | Tanımlayan: | ||
|---|---|---|---|
| actualLocaleIDName : String [salt okunur]
Bu NumberFormatter nesnesi tarafından kullanılan gerçek yerel ayar kimliğinin adı. | NumberFormatter | ||
![]() | constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | |
| decimalSeparator : String
Ondalık bölümü olan sayıların biçimlendirilmesi veya ayrıştırılması için kullanılan ondalık ayırıcı karakteri. | NumberFormatter | ||
| digitsType : uint
Sayılar biçimlendirilirken kullanılacak rakam karakterleri kümesini tanımlar. | NumberFormatter | ||
| fractionalDigits : int
Ondalık ayırıcıdan sonra görüntülenebilen maksimum basamak sayısı. | NumberFormatter | ||
| groupingPattern : String
Biçimlendirilen sayı dizesindeki gruplandırma ayırıcılarının yerleşimini açıklar. | NumberFormatter | ||
| groupingSeparator : String
Gruplandırma ayırıcı için kullanılan karakter veya dize. | NumberFormatter | ||
| lastOperationStatus : String [salt okunur]
Bu NumberFormatter nesnesinin gerçekleştirdiği önceki işlemin durumu. | NumberFormatter | ||
| leadingZero : Boolean
Ondalık ayırıcının solunda bir tam sayı basamağı olmadığında, biçimlendirilen sayının başına sıfır sayısının eklenip eklenmeyeceğini belirtir. | NumberFormatter | ||
| negativeNumberFormat : uint
Negatif sayılar için biçimlendirme desenini belirten sayısal bir değer. | NumberFormatter | ||
| negativeSymbol : String
Negatif değerler biçimlendirilirken kullanılacak negatif sembolü. | NumberFormatter | ||
| requestedLocaleIDName : String [salt okunur]
Bu NumberFormatter nesnesinin yapıcısına iletilmiş olan istenen yerel ayar kimliğinin adı. | NumberFormatter | ||
| trailingZeros : Boolean
Sondaki sıfırların biçimlendirilen bir sayıya dahil edilip edilmeyeceğini belirtir. | NumberFormatter | ||
| useGrouping : Boolean
Sayılar biçimlendirilirken gruplandırma ayırıcısının kullanılmasına olanak sağlar. | NumberFormatter | ||
| Yöntem | Tanımlayan: | ||
|---|---|---|---|
NumberFormatter(requestedLocaleIDName:String)
Belirli bir yerel ayarın kurallarına göre sayıları biçimlendirmek için yeni bir NumberFormatter nesnesi oluşturur. | NumberFormatter | ||
Bir int değerini biçimlendirir. | NumberFormatter | ||
Bir Number değerini biçimlendirir. | NumberFormatter | ||
Bir uint değerini biçimlendirir. | NumberFormatter | ||
[statik]
Bu sınıf tarafından desteklenen tüm yerel ayar kimlik adlarını listeler. | NumberFormatter | ||
![]() |
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | |
![]() |
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | |
Bir dizeyi ayrıştırır ve ayrıştırılan öğeleri içeren bir NumberParseResult nesnesini döndürür. | NumberFormatter | ||
Yalnızca basamaklar ve isteğe bağlı beyaz boşluk karakterleri içeren bir dize ayrıştırır. | NumberFormatter | ||
![]() |
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | |
![]() |
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | |
![]() |
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | |
![]() |
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | |
![]() |
Belirtilen nesnenin temel değerini döndürür. | Object | |
actualLocaleIDName | özellik |
actualLocaleIDName:String [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Bu NumberFormatter 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.
- İstenen yerel ayar
LocaleID.DEFAULTdeğ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. LocaleID.DEFAULT, yapıcıyarequestedLocaleIDNameparametresinin 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.DEFAULTdeğeri, OS'de kullanıcının özelleştirilmiş ayarını saklar.requestedLocaleIDNameparametresi olarak açık bir değerin iletilmesi, iki yerel ayar kimliği aynı olsa da,LocaleID.DEFAULTkullanılmasıyla aynı sonucu vermeyebilir. Kullanıcı makinesinde yerel ayarları özelleştirmiş olabilir veLocaleID.DEFAULTöğesini kullanmak yerine açık yerel ayar kimlik adı isteyerek uygulamanız bu özelleştirilmiş ayarları almaz.- Sistem, yapıcıda belirtilen
requestedLocaleIDNameöğesini desteklemiyorsa, bir geri dönüş yerel ayarı kimlik adı sağlanır.
Uygulama
public function get actualLocaleIDName():Stringİlgili API Öğeleri
decimalSeparator | özellik |
decimalSeparator:String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Ondalık bölümü olan sayıları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 locale and operating system..
Uygulama
public function get decimalSeparator():String public function set decimalSeparator(value:String):voidAtar
TypeError — bu özelliğe null değeri atanırsa.
|
İlgili API Öğeleri
digitsType | özellik |
digitsType:uint| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Sayılar biçimlendirilirken kullanılacak rakam 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 locale and operating system..
Uygulama
public function get digitsType():uint public function set digitsType(value:uint):voidAtar
TypeError — bu özelliğe null değeri atanırsa.
|
İlgili API Öğeleri
fractionalDigits | özellik |
fractionalDigits:int| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
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.
Uygulama
public function get fractionalDigits():int public function set fractionalDigits(value:int):voidİlgili API Öğeleri
groupingPattern | özellik |
groupingPattern:String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Biçimlendirilen sayı 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 sayısının çeşitli gruplandırma desenleriyle biçimlendirilmesinin örnekleri gösterilmektedir. Gruplandırma ayırıcı bir virgül ve ondalık ayırıcı da bir noktadır.
| Gruplandırma Deseni | Örnek Biçim |
3;* | 123,456,789.12 |
3;2;* | 12,34,56,789.12 |
3 | 123456,789.12 |
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.
Uygulama
public function get groupingPattern():String public function set groupingPattern(value:String):voidAtar
TypeError — bu özelliğe null değeri atanırsa.
|
İlgili API Öğeleri
groupingSeparator | özellik |
groupingSeparator:String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Gruplandırma ayırıcı için kullanılan karakter veya dize.
useGrouping özelliği true olduğunda, bu özelliğin değeri, sayılar 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 locale and operating system..
Uygulama
public function get groupingSeparator():String public function set groupingSeparator(value:String):voidAtar
TypeError — bu özelliğe null değeri atanırsa.
|
İlgili API Öğeleri
lastOperationStatus | özellik |
lastOperationStatus:String [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Bu NumberFormatter nesnesinin gerçekleştirdiği önceki 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.
Uygulama
public function get lastOperationStatus():Stringİlgili API Öğeleri
leadingZero | özellik |
leadingZero:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Ondalık ayırıcının solunda bir tam sayı basamağı olmadığında, biçimlendirilen sayı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, sayı 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 sayıların nasıl biçimlendirildiğine dair örnekler gösterilmektedir.
| trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
| true | true | 3 | 0.120 | 0.000 |
| false | true | 3 | 0.12 | 0 |
| true | false | 3 | .120 | .000 |
| false | false | 3 | .12 | 0 |
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 locale and operating system..
Uygulama
public function get leadingZero():Boolean public function set leadingZero(value:Boolean):voidAtar
TypeError — bu özelliğe null değeri atanırsa.
|
İlgili API Öğeleri
negativeNumberFormat | özellik |
negativeNumberFormat:uint| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Negatif sayılar için biçimlendirme desenini belirten sayısal bir değer. Bu desen, biçimlendirilen sayının sayısal kısmına göre negatif sembolünün veya parantezlerin konumunu tanımlar.
Aşağıdaki tabloda, negatif sayılar için olası biçimler özetlenmektedir. Negatif bir sayı biçimlendirildiğinde, biçimdeki eksi işaretinin yerine negativeSymbol özelliğinin değeri gelir ve 'n' karakterinin yerine de biçimlendirilen sayısal değer gelir.
| Negatif sayı biçimi türü | Biçim |
| 0 | (n) |
| 1 | -n |
| 2 | - n |
| 3 | n- |
| 4 | n - |
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 locale and operating system..
Uygulama
public function get negativeNumberFormat():uint public function set negativeNumberFormat(value:uint):voidAtar
ArgumentError — atanan değer 0 ile 4 arasında bir sayı değilse.
|
İlgili API Öğeleri
negativeSymbol | özellik |
negativeSymbol:String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Negatif değerler biçimlendirilirken kullanılacak negatif sembolü.
Bu sembol, sıfırdan küçük bir sayı biçimlendirilirken negatif sayı biçimiyle birlikte kullanılır. Negatif işareti içermeyen negatif sayı biçimlerinde (örn. negatif sayılar parantez içine alındığında) kullanılmaz.
Bu özellik, bu biçimlendirici oluşturulduğunda seçilen gerçek yerel ayarın varsayılan bir değerine ayarlanır. Varsayılan ayarı geçersiz kılmak için bir değerle ayarlanabilir.
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.
Uygulama
public function get negativeSymbol():String public function set negativeSymbol(value:String):voidAtar
MemoryError — sistem yeterince dahili bellek ayıramıyorsa.
|
İlgili API Öğeleri
requestedLocaleIDName | özellik |
requestedLocaleIDName:String [salt okunur] | Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Bu NumberFormatter 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.
Uygulama
public function get requestedLocaleIDName():Stringİlgili API Öğeleri
trailingZeros | özellik |
trailingZeros:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Sondaki sıfırların biçimlendirilen bir sayıya 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, sayısal değer 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 sayısal değerlerin nasıl biçimlendirildiğine dair örnekler gösterilmektedir.
| trailingZeros | leadingZero | fractionalDigits | 0.12 | 0 |
| true | true | 3 | 0.120 | 0.000 |
| false | true | 3 | 0.12 | 0 |
| true | false | 3 | .120 | .000 |
| false | false | 3 | .12 | 0 |
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 locale and operating system..
Uygulama
public function get trailingZeros():Boolean public function set trailingZeros(value:Boolean):voidAtar
TypeError — bu özelliğe null değeri atanırsa.
|
İlgili API Öğeleri
useGrouping | özellik |
useGrouping:Boolean| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Sayılar 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.22
useGrouping özelliği false değerine ayarlandığında, basamaklar gruplandırılmaz veya ayrılmaz. Örneğin: 123456789.22
Gruplandırma ayırıcı olarak kullanılacak sembol, groupingSeparator özelliği tarafından tanımlanır. Gruplandırma ayırıcıları arasındaki basamakların sayısı, groupingPattern özelliği tarafından tanımlanı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.
Uygulama
public function get useGrouping():Boolean public function set useGrouping(value:Boolean):voidİlgili API Öğeleri
NumberFormatter | () | Yapıcı |
public function NumberFormatter(requestedLocaleIDName:String)| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Belirli bir yerel ayarın kurallarına göre sayıları biçimlendirmek için yeni bir NumberFormatter 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.
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ı 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_WARNINGLastOperationStatus.USING_DEFAULT_WARNING
Bu sınıf geçerli işletim sisteminde desteklenmiyorsa, lastOperationStatus özelliği şu değere ayarlanır:
LastOperationStatus.UNSUPPORTED_ERROR
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.
requestedLocaleIDName:String — Sayı biçimleri belirlenirken kullanılacak tercih edilen yerel alan kimliği adı.
|
Atar
TypeError — requestedLocaleIDName null ise
|
İlgili API Öğeleri
formatInt | () | yöntem |
public function formatInt(value:int):String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Bir int değerini biçimlendirir. Bu işlev, formatNumber() yöntemine eşdeğerdir, tek farkı bir int değeri almasıdır. İletilen değer çok büyük veya çok küçükse (örn. 1.72e308'den büyük bir değer veya 1.72e-308'den küçük bir değer), bu işlev 0 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.
Parametreler
value:int — Biçimlendirilecek bir int değeri.
|
String — Biçimlendirilmiş bir sayı dizesi.
|
Atar
MemoryError — herhangi bir dahili bellek ayırma sorunu için.
|
İlgili API Öğeleri
formatNumber | () | yöntem |
public function formatNumber(value:Number):String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Bir Number değerini biçimlendirir.
Bu işlev, biçimlendiricinin özellik değerlerini temel alarak sayıyı biçimlendirir. numberFormatter nesnesi oluşturulduktan sonra özellikler değiştirilmezse, sayılar, actualLocaleIDName tarafından tanımlanan yerel ayar için işletim sistemi tarafından sağlanan yerel ayara özel kurallara göre biçimlendirilir. Biçimi biçimlendirmek için, biçimlendirme sayısının belirli yönlerini denetlemek üzere özellikler değiştirilebilir.
Bu işlevle çok büyük sayılar ve çok küçük sayılar biçimlendirilebilir. Ancak, önemli basamakların sayısı, Number nesnesinin sağladığı kesinlikle sınırlıdır. Bilimsel notasyon desteklenmez.
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
value:Number — Biçimlendirilecek bir Number değeri.
|
String — Biçimlendirilmiş bir sayı dizesi.
|
Atar
MemoryError — Herhangi bir dahili bellek ayırma sorunu varsa.
|
İlgili API Öğeleri
formatUint | () | yöntem |
public function formatUint(value:uint):String| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Bir uint değerini biçimlendirir. Bu işlev, formatNumber() yöntemine eşdeğerdir, tek farkı bir uint değeri almasıdır. İletilen değer çok büyükse (örn. 1.72e308 değerinden büyükse), bu işlev 0 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.
Parametreler
value:uint — Bir uint değeri.
|
String — Biçimlendirilmiş bir sayı dizesi.
|
Atar
MemoryError — Herhangi bir dahili bellek ayırma sorunu varsa.
|
İlgili API Öğeleri
getAvailableLocaleIDNames | () | yöntem |
public static function getAvailableLocaleIDNames():Vector.<String>| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
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.
Vector.<String> — Bu sınıf tarafından desteklenen tüm yerel ayar kimlik adlarını içeren dizelerden oluşan bir vektör öğesi.
|
parse | () | yöntem |
public function parse(parseString:String):NumberParseResult| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Bir dizeyi ayrıştırır ve ayrıştırılan öğeleri içeren bir NumberParseResult nesnesini döndürür.
NumberParseResult nesnesi, girdi dizesinde bulunan ilk sayının, dizedeki sayının başlangıç dizininin ve dizedeki sayıdan sonra gelen birinci karakterin dizininin değerini içerir.
Dize bir sayı içermiyorsa, NumberParseResult öğesinin değeri NaN olarak ayarlanır ve startIndex ile endIndex özellikleri de 0x7fffffff onaltılı değerine ayarlanır.
Bu işlev, sayının kesir basamağını içeren kısmını belirlemek için decimalSeparator özelliğinin değerini, bir sayının basamaklarında hangi karakterlere izin verildiğini belirlemek için groupingSeparator özelliğinin değerini ve negatif değerlerin nasıl temsil edildiğini denetlemek için negativeNumberFormat özelliğinin değerini kullanır.
Aşağıdaki tablo, çeşitli NegativeNumberFormat değerleri için ayrıştırılan dizelerin sonucunu tanımlar:
| NegativeNumberFormat | Giriş Dizesi | Sonuç |
| (n) | "(123)" veya "( 123 )" | "-123" |
| -n | "-123" veya "- 123" | "-123" |
| - n | "-123" veya "- 123" | "-123" |
| n- | "123-" veya "123 -" | "-123" |
| n - | "123-" veya "123 -" | "-123" |
Sayı ile eksi işareti veya parantez arasında tek bir beyaz boşluğa izin verilir.
Geçerli bir sayı belirlenirken diğer özellikler yok sayılır. Özellikle, digitsType özelliğinin değeri yok sayılır ve basamaklar, NationalDigitsType sınıfında numaralandırılmış basamak kümelerinden herhangi birinden olabilir. groupingPattern ve useGrouping özelliklerinin değerleri, sayının ayrıştırılmasını etkilemez.
Dizede sayıların önüne veya arkasına bir artı işareti '+' gelirse, bu artı işareti, sayının parçası olmayan bir karakter olarak değerlendirilir.
Bu işlev, bilimsel gösterimde sayılar içeren dizeleri ayrıştırmaz (örn. 1.23e40).
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
parseString:String |
NumberParseResult |
Atar
TypeError — parseString null ise
|
İlgili API Öğeleri
Örnek ( Bu örnek nasıl kullanılır? )
var nf:NumberFormatter = new NumberFormatter("fr-FR");
var str:String = "1,56 mètre"
var result:NumberParseResult = nf.parse(str);
trace(result.value) // 1.56
trace(str.substr(0,result.startIndex)); // ""
trace(str.substr(result.startIndex, result.endIndex)); // "1,56"
trace(str.substr(result.endIndex)); // " mètre"
parseNumber | () | yöntem |
public function parseNumber(parseString:String):Number| Dil Sürümü: | ActionScript 3.0 |
| Çalışma Zamanı Sürümleri: | Flash Player 10.1, AIR 2 |
Yalnızca basamaklar ve isteğe bağlı beyaz boşluk karakterleri içeren bir dize ayrıştırır. Dize bir sayıyla başlamıyorsa veya beyaz boşluk dışında, sayının parçası olmayan karakterler içeriyorsa, bu yöntem NaN değerini döndürür. Sayısal basamaklardan önce ve sonra gelen beyaz boşluk yok sayılır. Beyaz boşluk, Unicode Character Database'deki (Unicode Karakter Veritabanı) (bkz. http://www.unicode.org/ucd/) Boşluk Ayırıcı (Zs) özelliğine sahip bir karakterdir.
Sayısal rakamın önünden veya arkasından bir artı işareti '+' geliyorsa, beyaz boşluk olmayan bir karakter gibi işlem görür. Döndürme değeri NaN değeridir.
Sayı ayrıştırma ve nelerin geçerli bir sayı oluşturduğuyla ilgili daha fazla bilgi almak için ayrıştırma işlevinin açıklamasına bakın.
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
parseString:String |
Number |
Atar
TypeError — parseString null ise
|
İlgili API Öğeleri
Bu örnek, şu yerel ayarları kullanır: Sayı biçimlendirmesi için işletim sisteminin varsayılan yerel ayarı, Japonca (Japonya), İngilizce (ABD) ve Fransızca (Fransa). Örnek, varsayılan işletim sisteminin yerel ayarını istemek için LocaleID.DEFAULT statik üyesini kullanır.
Bu örnekteki sonuçlar, işletim sisteminize ve kullanıcı tercihlerine göre farklılık gösterebilir.
Bu örnek listedeki her yerel ayar için aşağıdakileri yapar:
- Bir NumberFormatter nesnesi oluşturur.
- Aynı değeri bir Sayı, bir tam sayı ve imzasız bir tam sayı olarak biçimlendirir ve sonuçları görüntüler.
package {
import flash.globalization.NumberFormatter;
import flash.globalization.LocaleID;
public class NumberFormatterExample extends Sprite
{
public function NumberFormatterExample():void
{
var localeNames:Array = [LocaleID.DEFAULT,"ja_JP","en_US","fr_FR"];
for ( var i:int = 0; i < localeNames.length; i++ )
{
var nf:NumberFormatter = new NumberFormatter( localeNames[i] as String );
trace('\n\n' + "LocaleID requested: " + nf.requestedLocaleIDName
+ "; actual: " + nf.actualLocaleIDName);
trace( "Last Operation Status:" + nf.lastOperationStatus );
var numberString:String = nf.formatNumber(123456789.19);
trace( "Formatted Number:" + numberString);
numberString = nf.formatInt(-123456789);
trace( "Formatted Int:" + numberString);
numberString = nf.formatUint(123456789);
trace( "Formatted UInt:" + numberString);
}
}
}
}
Bu örnekteki sonuçlar, işletim sisteminize ve kullanıcı tercihlerine göre farklılık gösterebilir.
Bu örnek aşağıdakileri yapar:
- Bir NumberFormatter nesnesi oluşturur.
- Dizeyi ayrıştırıp bir NumberParseResult nesnesi döndürmek için
NumberFormatter.parse()yöntemini çağırır. - Dizeyi ayrıştırıp bir Sayı değeri döndürmek için
NumberFormatter.parseNumber()yöntemini çağırır.
package {
import flash.globalization.NumberFormatter;
import flash.globalization.NumberParseResult;
import flash.globalization.LastOperationStatus;
import flash.globalization.LocaleID;
public class NumberFormatterParseExample
{
public function NumberFormatterParseExample():void
{
var nf:NumberFormatter = new NumberFormatter( "en_US" );
trace("LocaleID requested: " + nf.requestedLocaleIDName
+ "; actual: " + nf.actualLocaleIDName);
trace( "Last Operation Status:" + nf.lastOperationStatus );
var inputNumberString:String = "123,567,89,0.254";
var parseResult:NumberParseResult = nf.parse(inputNumberString);
if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
trace("Parsed value:" + parseResult.value);
}
inputNumberString = "-123,567,89,0.254";
var parsedNumber:Number = nf.parseNumber(inputNumberString);
if ( nf.lastOperationStatus == LastOperationStatus.NO_ERROR ) {
trace("Parsed value:" + parsedNumber);
}
}
}
}
Tue Jun 12 2018, 01:09 PM Z
Miras Alınan Genel Özellikleri Gizle
Miras Alınan Genel Özellikleri Göster