Number

Pakiet	Najwyższy poziom
Klasa	public final class Number
Dziedziczenie	Number Object

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Typ danych pozwalający reprezentować liczby zmiennoprzecinkowe o podwójnej precyzji (IEEE-754). Pierwotne wartości liczbowe można zmieniać za pomocą metod i właściwości skojarzonych z klasą Number. Ta klasa jest identyczna z klasą Number obsługiwaną przez język JavaScript.

Właściwości klasy Number są statyczne, co oznacza, że do ich obsługi nie wymaga się obiektu, a więc również i konstruktora.

Typ danych Number odpowiada standardowi podwójnej precyzji określonemu jako IEEE-754.

Typ danych Number sprawdza się w przypadku korzystania z wartości liczb zmiennoprzecinkowych. Środowisko wykonawcze Flash obsługuje typy danych int oraz uint sprawniej niż typ danych Number. Jednakże ten ostatni typ danych jest przydatny w sytuacjach, w których zakres wymaganych wartości przekracza poprawny zakres wymaganych wartości dla typów danych int i uint. Klasa Number może reprezentować wartości liczb całkowitych znajdujących się daleko poza poprawnym zakresem wartości dla typu danych int oraz uint. Typ danych Number może wykorzystywać aż do 53 bitów, aby reprezentować wartości liczb całkowitych, w porównaniu do 32 bitów dostępnych typów danych int oraz uint. Wartością domyślna zmiennej typu Number jest wartość NaN (z ang. „Not a Number”).

Wyświetl przykłady

Powiązane elementy interfejsu API

int
uint

Właściwości publiczne

Ukryj dziedziczone właściwości publiczne

Pokaż dziedziczone właściwości publiczne

	Właściwość		Zdefiniowane przez
		constructor : Object Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu.	Object

Metody publiczne

Ukryj dziedziczone metody publiczne

Pokaż dziedziczone metody publiczne

	Metoda		Zdefiniowane przez
		Number(num:Object) Tworzy obiekt Number o określonej wartości.	Number
		hasOwnProperty(name:String):Boolean Wskazuje, czy dla obiektu zdefiniowano określoną właściwość.	Object
		isPrototypeOf(theClass:Object):Boolean Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Wskazuje, czy określona właściwość istnieje i jest przeliczalna.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Ustawia dostępność właściwości dynamicznej używanej w pętlach.	Object
		toExponential(fractionDigits:uint):String Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej.	Number
		toFixed(fractionDigits:uint):String Zwraca ciąg znaków reprezentujący liczbę w notacji dziesiętnej.	Number
		toLocaleString():String Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych.	Object
		toPrecision(precision:uint):String Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej lub dziesiętnej.	Number
		toString(radix:Number = 10):String Zwraca ciąg znaków reprezentujący określony obiekt Number (myNumber).	Number
		valueOf():Number Zwraca typ wartości pierwotnej określonego obiektu Number.	Number

Stałe publiczne

	Stała		Zdefiniowane przez
		MAX_VALUE : Number [statyczny] Największa, możliwa do zakodowania, liczba (o podwójnej precyzji IEEE-754).	Number
		MIN_VALUE : Number [statyczny] Najmniejsza (najbliższa zeru, a nie najniższa ujemna) możliwa do zakodowania liczba IEEE-754, która w porównaniu różni się od 0.	Number
		NaN : Number [statyczny] Wartość IEEE-754 reprezentująca obiekt nieliczbowy (Not a Number, NaN).	Number
		NEGATIVE_INFINITY : Number [statyczny] Określa wartość IEEE-754 reprezentującą minus nieskończoność.	Number
		POSITIVE_INFINITY : Number [statyczny] Określa wartość IEEE-754 reprezentującą plus nieskończoność.	Number

Konstruktor Szczegół

()

Konstruktor

public function Number(num:Object)

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Tworzy obiekt Number o określonej wartości. Rezultaty użycia konstruktora są takie same jak rezultaty otrzymane za pomocą publicznej, macierzystej funkcji Number(), która konwertuje obiekt dowolnego typu na pierwotną wartość liczbową.

Parametry

num:Object — Wartość liczbowa utworzonej instancji Number lub wartość konwertowana na klasę Number. Jeśli parametr num nie został określony, wartością domyślną jest 0. Użycie konstruktora bez określonego parametru num nie jest tożsame z deklarowaniem zmiennej typu Number bez przypisanej wartości (jak np. var myNumber:Number), która przyjmuje wartość domyślną NaN. Liczba, której nie przypisano wartości jest niezdefiniowana i równoważna zapisowi new Number(undefined).

Powiązane elementy interfejsu API

Number.toString()
Number.valueOf()

Szczegół metody

toExponential

()

metoda

AS3 function toExponential(fractionDigits:uint):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0, Flash Lite 4

Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej. Ciąg znaków zawiera jedną cyfrę przed przecinkiem i do 20 cyfr po przecinku określonych za pomocą parametru fractionDigits.

Parametry

fractionDigits:uint — Liczba całkowita z zakresu od 0 do 20 włącznie, która reprezentuje żądaną liczbę miejsc dziesiętnych.

Zwraca

String

Zgłasza

RangeError — Generuje wyjątek, jeśli argument fractionDigits znajduje się poza zakresem wartości od 0 do 20.

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zwrot za pomocą metody toExponential(2) ciągu znaków w notacji wykładniczej.


var num:Number = 315003;
trace(num.toExponential(2)); // 3.15e+5

toFixed

()

metoda

AS3 function toFixed(fractionDigits:uint):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0, Flash Lite 4

Zwraca ciąg znaków reprezentujący liczbę w notacji dziesiętnej. Notacja dziesiętna oznacza, że po przecinku ciąg będzie zawierał daną liczbę cyfr określoną za pomocą parametru fractionDigits. Zakres poprawnych wartości dla parametru fractionDigits to wartości od 0 do 20. Określenie wartości spoza tego zakresu wygeneruje wyjątek.

Parametry

fractionDigits:uint — Liczba całkowita z zakresu od 0 do 20 włącznie, która reprezentuje żądaną liczbę miejsc dziesiętnych.

Zwraca

String

Zgłasza

RangeError — Generuje wyjątek, jeśli argument fractionDigits znajduje się poza zakresem wartości od 0 do 20.

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zwrot za pomocą metody toFixed(3) ciągu liczb, który jest zaokrąglany do trzech miejsc po przecinku.


var num:Number = 7.31343;
trace(num.toFixed(3)); // 7.313

Poniższy przykład ilustruje zwrot za pomocą metody toFixed(2) ciągu liczb z dodanymi kończącymi zerami.


var num:Number = 4;
trace(num.toFixed(2)); // 4.00

toPrecision

()

metoda

AS3 function toPrecision(precision:uint):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

Flash Player 9, AIR 1.0, Flash Lite 4

Zwraca ciąg znaków reprezentujący liczbę w notacji wykładniczej lub dziesiętnej. Ciąg będzie zawierał liczbę cyfr określoną za pomocą parametru precision.

Parametry

precision:uint — Liczba całkowita z zakresu od 1 do 21 włącznie, określająca żądaną liczbę cyfr, które wynikowy ciąg znaków będzie zawierał.

Zwraca

String

Zgłasza

RangeError — Generuje wyjątek, jeśli argument precision znajduje się poza zakresem wartości od 1 do 21.

Przykład ( Sposób korzystania z tego przykładu )

Poniższy przykład ilustruje zwrot za pomocą metody toPrecision(3) ciągu tylko trzech cyfr. Ciąg jest w notacji dziesiętnej, ponieważ notacja wykładnicza nie jest konieczna.


var num:Number = 31.570;
trace(num.toPrecision(3)); // 31.6

Poniższy przykład ilustruje zwracanie za pomocą metody toPrecision(3) ciągu tylko trzech cyfr. Ciąg jest w notacji wykładniczej, ponieważ dla dziesiętnej notacji liczby wynikowej nie określono wystarczającej liczby miejsc dziesiętnych.


var num:Number = 4000;
trace(num.toPrecision(3)); // 4.00e+3

toString

()

metoda

AS3 function toString(radix:Number = 10):String

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca ciąg znaków reprezentujący obiekt Number (myNumber). Jeśli wartość obiektu Number stanowi liczba dziesiętna bez zera początkowego (jak np. ,4), za pomocą metody Number.toString() zero początkowe zostaje dodane (0,4).

Parametry

radix:Number (default = 10) — Określa wartość liczbową podstawy obliczeń (od 2 do 36) wykorzystywaną do konwersji liczby na ciąg znaków. Jeśli parametr radix nie został określony, wartością domyślną jest 10.

Zwraca

String — Numeryczna reprezentacja obiektu Number za pomocą ciągu znaków.

valueOf

()

metoda

AS3 function valueOf():Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Zwraca typ pierwotnej wartości określonego obiektu Number.

Zwraca

Number — Typ wartości pierwotnej obiektu Number.

Szczegół stałej

MAX_VALUE

Stała

public static const MAX_VALUE:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Największa, możliwa do zakodowania, liczba (o podwójnej precyzji IEEE-754). Liczba ta wynosi w przybliżeniu 1,79e+308.

MIN_VALUE

Stała

public static const MIN_VALUE:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Najmniejsza (najbliższa zeru, a nie najniższa ujemna) możliwa do zakodowania liczba IEEE-754, która w porównaniu różni się od 0. W przypadku większości platform ta liczba to około 5e-324, ale może być większa w systemach, które nie obsługują liczb małych. Na przykład w systemie iOS wartość tej stałej wynosi 2,225e-308.

Uwaga: Najmniejsza dopuszczalna liczba możliwa do zakodowania to –Number.MAX_VALUE.

NaN

Stała

public static const NaN:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Wartość IEEE-754 reprezentująca obiekt nieliczbowy (Not a Number, czyli NaN).

Powiązane elementy interfejsu API

isNaN() funkcja globalna

NEGATIVE_INFINITY

Stała

public static const NEGATIVE_INFINITY:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Określa wartość IEEE-754 reprezentującą minus nieskończoność. Wartość tej właściwości jest taka sama, jak wartość stałej -Infinity.

Minus nieskończoność stanowi specjalną wartość liczbową zwracaną wówczas, gdy wynikiem funkcji lub operacji matematycznej jest ujemna wartość większa od największej wartości możliwej do zakodowania.

POSITIVE_INFINITY

Stała

public static const POSITIVE_INFINITY:Number

Wersja języka:

ActionScript 3.0

Wersje środowiska wykonawczego:

AIR 1.0, Flash Player 9, Flash Lite 4

Określa wartość IEEE-754 reprezentującą plus nieskończoność. Wartość tej właściwości jest taka sama, jak wartość stałej Infinity.

Plus nieskończoność stanowi specjalną wartość liczbową zwracaną wówczas, gdy wynikiem funkcji lub operacji matematycznej jest wartość większa od największej wartości możliwej do zakodowania.

Przykłady Sposób korzystania z tego przykładu

NumberExample.as

Poniższy przykład ilustruje sposób, w jaki liczba z sześcioma miejscami dziesiętnymi jest przycinana (z zaokrągleniem) do liczby z dwoma miejscami dziesiętnymi.


package {
    import flash.display.Sprite;

    public class NumberExample extends Sprite {
        public function NumberExample() {
            var num:Number = new Number(10.456345);
            var str:String = num.toFixed(2);
            trace(num); // 10.456345
            trace(str); // 10.46
        }
    }
}

Informacje prawne | Zasady prywatności online

Number - AS3

Klasy x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY