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.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. LocaleID.DEFAULT
, yapıcıyarequestedLocaleIDName
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 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):void
Atar
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):void
Atar
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):void
Atar
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):void
Atar
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):void
Atar
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):void
Atar
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):void
Atar
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):void
Atar
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_WARNING
LastOperationStatus.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