Number

Balíček	Nejvyšší úroveň
Třída	public final class Number
Zdědění	Number Object

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Datový typ představující číslo s pohyblivou čárkou s dvojitou přesností IEEE-754. Můžete zpracovávat primitivní číselné hodnoty pomocí metod a vlastností, sdružených do třídy Number. Tato třída je shodná se třídou Number v prostředí JavaScript.

Vlastnosti třídy Number jsou statické, což znamená, že nepotřebujete objekt, abyste je mohli použít, a proto nepotřebujete použít konstruktor.

Datový typ Number zachovává dvojitou přesnost dle normy IEEE-754.

Datový typ Number je užitečný při použití hodnot s plovoucí čárkou. Běhové moduly Flash pracují s datovými typy int a uint efektivněji než s typem Number, typ Number je ale užitečný v situacích, kdy požadovaný rozsah hodnot přesahuje platný rozsah datových typů int a uint. Třída Number může být použita pro znázornění hodnot celého čísla podstatně za platným rozsahem typu dat int a uint. Datový typ Number může na znázornění celých čísel použít až 53 bitů, ve srovnání s 32 bity, dostupnými pro int a uint. Výchozí hodnota proměnné typu Number je NaN (ne číslo).

Zobrazit příklady

Další příklady

Typy dat
Popisy typů dat
Převody typu

Elementy souvisejícího rozhraní API

int
uint

Veřejné vlastnosti

Skrýt zděděné veřejné vlastnosti

Zobrazit zděděné veřejné vlastnosti

	Vlastnost		Definoval
		constructor : Object Odkaz na objekt třídy nebo funkci konstruktoru pro danou instanci objektu.	Object
		prototype : Object [statický] Odkaz na objekt prototypu objektu třídy nebo funkce.	Object

Veřejné metody

Skrýt zděděné veřejné metody

Zobrazit zděděné veřejné metody

	Metoda		Definoval
		Number(num:Object) Vytvoří objekt Number s určenou hodnotou.	Number
		hasOwnProperty(name:String):Boolean Označuje, zda má objekt definovanou určenou vlastnost.	Object
		isPrototypeOf(theClass:Object):Boolean Označuje, zda se vyskytuje instance třídy Object v řetězci prototypu objektu určeného jako parametr.	Object
		propertyIsEnumerable(name:String):Boolean Označuje, zda určená vlastnost existuje a je spočitatelná.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Nastavuje dostupnost dynamické vlastnosti pro cyklus For.	Object
		toExponential(fractionDigits:uint):String Vrátí řetězcové vyjádření čísla v exponenciálním zápisu.	Number
		toFixed(fractionDigits:uint):String Vrátí řetězcové vyjádření čísla v zápisu s pevnou čárkou.	Number
		toLocaleString():String Vrátí řetězcové vyjádření tohoto objektu zformátované podle konvencí národního prostředí.	Object
		toPrecision(precision:uint):String Vrátí řetězcové vyjádření čísla buď v exponenciálním zápisu nebo v zápisu s pevnou čárkou.	Number
		toString(radix:Number = 10):String Vrátí řetězcové vyjádření určeného objektu Number (myNumber).	Number
		valueOf():Number Vrátí typ primitivní hodnoty určeného objektu Number.	Number

Veřejné konstanty

	Konstanta		Definoval
		MAX_VALUE : Number [statický] Největší číslo, jaké lze vyjádřit (dvojitá přesnost IEEE-754).	Number
		MIN_VALUE : Number [statický] Nejmenší nezáporné nenulové číslo, jaké lze vyjádřit (dvojitá přesnost IEEE-754).	Number
		NaN : Number [statický] Hodnota IEEE-754 představující NaN (Není číslo).	Number
		NEGATIVE_INFINITY : Number [statický] Určuje hodnotu IEEE-754 představující záporné nekonečno.	Number
		POSITIVE_INFINITY : Number [statický] Určuje hodnotu IEEE-754 představující kladné nekonečno.	Number

Detail konstruktoru

()

Konstruktor

public function Number(num:Object)

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Vytvoří objekt Number s určenou hodnotou. Tento konstruktor má stejný výsledek, jako obecná přirozená funkce Number(), která převádí objekt různého typu na primitivní číselnou hodnotu.

Parametry

num:Object — Číselná hodnota vytvořené instance Number nebo hodnota, která má být převedena na číslo. Když není určen parametr num, je nastavena výchozí hodnota 0. Použít konstruktora bez určení parametru num není stejné, jako deklarování proměnné typu Number s nepřiřazenou hodnotou (jako třeba var myNumber:Number), která je pak standardně NaN. Číslo s nepřiřazenou hodnotou je nedefinované a rovnocené new Number(undefined).

Další příklady

Typy dat
Popisy typů dat
Převody typu

Elementy souvisejícího rozhraní API

Number.toString()
Number.valueOf()

Detail metody

toExponential

()

metoda

AS3 function toExponential(fractionDigits:uint):String

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

Flash Player 9, AIR 1.0, Flash Lite 4

Vrátí řetězcové vyjádření čísla v exponenciálním zápisu. Řetězec obsahuje jednu číslici před desetinnou čárkou a až 20 číslic za desetinnou čárkou, jak je určeno v parametru fractionDigits.

Parametry

fractionDigits:uint — Celé číslo mezi 0 a 20 včetně, představující požadovaný počet desetinných míst.

Vrací

String

Odesílá

RangeError — Generuje výjimku, pokud je argument fractionDigits mimo rozsah 0 až 20.

Příklad ( Použití tohoto příkladu )

V následujícím příkladu se ukazuje, jak toExponential(2) vrátí řetězec v exponenciálním zápisu.


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

toFixed

()

metoda

AS3 function toFixed(fractionDigits:uint):String

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

Flash Player 9, AIR 1.0, Flash Lite 4

Vrátí řetězcové vyjádření čísla v zápisu s pevnou čárkou. Zápis s pevnou čárkou znamená, že řetězec bude obsahovat specifický počet číslic za desetinou čárkou, jak je určeno v parametru fractionDigits. Platný rozsah parametru fractionDigits je od 0 do 20. Stanovení hodnoty mimo tento rozsah generuje výjimku.

Parametry

fractionDigits:uint — Celé číslo mezi 0 a 20 včetně, představující požadovaný počet desetinných míst.

Vrací

String

Odesílá

RangeError — Generuje výjimku, pokud je argument fractionDigits mimo rozsah 0 až 20.

Příklad ( Použití tohoto příkladu )

V následujícím příkladu se ukazuje, jak toFixed(3) vrátí řetězec, který zaokrouhluje na tři desetinná čísla.


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

V následujícím příkladu se ukazuje, jak toFixed(2) vrátí řetězec, který přidává ukončující nuly.


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

toPrecision

()

metoda

AS3 function toPrecision(precision:uint):String

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

Flash Player 9, AIR 1.0, Flash Lite 4

Vrátí řetězcové vyjádření čísla buď v exponenciálním zápisu nebo v zápisu s pevnou čárkou. Řetězec bude obsahovat počet číslic určený v parametru precision.

Parametry

precision:uint — Celé číslo mezi 1 a 21 včetně, představující požadovaný počet číslic znázorněných ve výsledném řetězci.

Vrací

String

Odesílá

RangeError — Generuje výjimku, pokud je argument precision mimo rozsah 1 až 21.

Příklad ( Použití tohoto příkladu )

V následujícím příkladu se ukazuje, jak toPrecision(3) vrátí řetězec pouze o třech číslicích. Řetězec je v zápisu s pevnou čárkou, protože exponenciální zápis není požadován.


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

V následujícím příkladu se ukazuje, jak toPrecision(3) vrátí řetězec pouze o třech číslicích. Řetězec je v exponenciálním zápisu, protože výsledné číslo nemá dostatečný počet znaků pro zápis s pevnou čárkou.


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

toString

()

metoda

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

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Vrací řetězcové vyjádření určeného objektu Number (myNumber). Je-li hodnota objektu Number desetinné číslo bez uvozující nuly.4), přidá ji funkce Number.toString() (0.4).

Parametry

radix:Number (default = 10) — Určuje číselný základ (od 2 do 36) použitý pro převod čísla na řetězec. Pokud neurčíte parametr radix, je nastavena výchozí hodnota 10.

Vrací

String — Číselné vyjádření objektu Number jako řetězec.

valueOf

()

metoda

AS3 function valueOf():Number

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Vrátí typ primitivní hodnoty určeného objektu Number.

Vrací

Number — Primitivní typ hodnoty objektu Number.

Detail konstanty

MAX_VALUE

Konstanta

public static const MAX_VALUE:Number

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Největší číslo, jaké lze vyjádřit (dvojitá přesnost IEEE-754). Toto číslo je přibližně 1,79e+308.

MIN_VALUE

Konstanta

public static const MIN_VALUE:Number

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Nejmenší nezáporné nenulové číslo, jaké lze vyjádřit (dvojitá přesnost IEEE-754). Toto číslo je přibližně 5e-324. Nejmenší číslo, které lze celkově vyjádřit je skutečně Number.MAX_VALUE

NaN

Konstanta

public static const NaN:Number

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Hodnota IEEE-754 představující ne číslo NaN.

Elementy souvisejícího rozhraní API

isNaN() globální funkce

NEGATIVE_INFINITY

Konstanta

public static const NEGATIVE_INFINITY:Number

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Určuje hodnotu IEEE-754 představující mínus nekonečno. Hodnota této vlastnosti je stejná jako hodnota konstanty mínus nekonečno.

Mínus nekonečno je speciální číselná hodnota která je vrácena, když matematická operace nebo funkce vrací zápornou hodnotu větší, než může být znázorněna.

POSITIVE_INFINITY

Konstanta

public static const POSITIVE_INFINITY:Number

Verze jazyka:

ActionScript 3.0

Verze chodu programu:

AIR 1.0, Flash Player 9, Flash Lite 4

Určuje hodnotu IEEE-754 představující plus nekonečno. Hodnota této vlastnosti je stejná jako hodnota konstanty plus nekonečno.

Plus nekonečno je speciální číselná hodnota která je vrácena, když matematická operace nebo funkce vrací hodnotu větší, než může být znázorněna.

Příklady Použití tohoto příkladu

NumberExample.as

Následující příklad ukazuje, jak je číslo se šesti číslicemi za desetinným místem zkráceno (se zaokrouhlením) na číslo se dvěma číslicemi za desetinným místem.


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

Právní upozornění | Zásady ochrany osobních údajů online

Number - AS3

Třídy x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY