Number

Pakket	Hoofdniveau
Klasse	public final class Number
Overerving	Number Object

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Een gegevenstype dat een IEEE-754 drijvende-kommagetal met dubbele precisie vertegenwoordigt. U kunt primitieve numerieke waarden manipuleren met de methoden en eigenschappen van de klasse Number. Deze klasse is identiek aan de JavaScript-klasse Number.

De eigenschappen van de klasse Number zijn statisch, met andere woorden, u hebt geen object nodig om ze te kunnen gebruiken. U hoeft dan ook niet de constructor te gebruiken.

Het gegevenstype Number voldoet aan de IEEE-754-standaard voor dubbele precisie.

Het gegevenstype Number is nuttig wanneer u drijvende-kommawaarden nodig hebt. Flash-runtimes verwerken de gegevenstypen int en uint efficiënter dan Number. Number is echter nuttig in situaties waarbij het vereiste bereik van waarden het geldige bereik van de gegevenstypen int en uint overschrijdt. De klasse Number kan waarden van gehele getallen vertegenwoordigen die ver buiten het geldige bereik van de gegevenstypen int en uint liggen. Het gegevenstype Number kan tot 53 bits gebruiken om waarden van gehele getallen te vertegenwoordigen, vergeleken met de 32 bits voor int en uint. De standaardwaarde van een variabele van het type Number is NaN (Not a Number).

Bekijk de voorbeelden

Verwante API-elementen

int
uint

Openbare eigenschappen

Overerfde openbare eigenschappen verbergen

Overerfde openbare eigenschappen weergeven

	Eigenschap		Gedefinieerd door
		constructor : Object Verwijzing naar het klasseobject of de constructorfunctie van een bepaalde objectinstantie.	Object

Openbare methoden

Overerfde openbare methoden verbergen

Overerfde openbare methoden weergeven

	Methode		Gedefinieerd door
		Number(num:Object) Maakt een object Number met de opgegeven waarde.	Number
		hasOwnProperty(name:String):Boolean Geeft aan of voor een object een opgegeven eigenschap is gedefinieerd.	Object
		isPrototypeOf(theClass:Object):Boolean Geeft aan of een instantie van de klasse Object zich in de prototypeketen van het object bevindt dat als parameter is opgegeven.	Object
		propertyIsEnumerable(name:String):Boolean Geeft aan of de opgegeven eigenschap bestaat en kan worden opgesomd.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Stelt de beschikbaarheid van een dynamische eigenschap voor lusbewerkingen in.	Object
		toExponential(fractionDigits:uint):String Retourneert een tekenreeksrepresentatie van het getal in exponentiële notatie.	Number
		toFixed(fractionDigits:uint):String Retourneert een tekenreeksrepresentatie van het getal in vaste-kommanotatie.	Number
		toLocaleString():String Geeft de tekenreeksweergave van dit object weer, geformatteerd volgens de locatiespecifieke conventies.	Object
		toPrecision(precision:uint):String Retourneert een tekenreeksrepresentatie van het getal in exponentiële notatie of vaste-kommanotatie.	Number
		toString(radix:Number = 10):String Retourneert de tekenreeksrepresentatie van het opgegeven object Number (myNumber).	Number
		valueOf():Number Retourneert het primitieve waardetype van het opgegeven object Number.	Number

Openbare constanten

	Constante		Gedefinieerd door
		MAX_VALUE : Number [statisch] Het grootst mogelijke getal (IEEE-754 met dubbele precisie).	Number
		MIN_VALUE : Number [statisch] Het kleinst mogelijke (het dichtst bij nul, niet het negatiefst) IEEE-754-getal dat niet gelijk is aan nul.	Number
		NaN : Number [statisch] De IEEE-754-waarde die Not a Number (NaN) vertegenwoordigt.	Number
		NEGATIVE_INFINITY : Number [statisch] Geeft de IEEE-754-waarde op die negatief oneindig vertegenwoordigt.	Number
		POSITIVE_INFINITY : Number [statisch] Geeft de IEEE-754-waarde op die positief oneindig vertegenwoordigt.	Number

Constructordetails

()

Constructor

public function Number(num:Object)

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Maakt een object Number met de opgegeven waarde. Deze constructor heeft hetzelfde effect als de openbare native functie Number() die een object van een ander type in een primitieve numerieke waarde omzet.

Parameters

num:Object — De numerieke waarde van de instantie Number dat wordt gemaakt of een waarde die in een getal moet worden omgezet. De standaardwaarde is 0 wanneer num niet wordt opgegeven. De constructor gebruiken zonder een parameter num op te geven is niet hetzelfde als een variabele van het type Number declareren zonder toegewezen waarde (zoals var myNumber:Number), wat standaard resulteert in NaN. Een getal zonder toegewezen waarde is ongedefinieerd en komt overeen met new Number(undefined).

Verwante API-elementen

Number.toString()
Number.valueOf()

Methodedetails

toExponential

()

methode

AS3 function toExponential(fractionDigits:uint):String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 9, AIR 1.0, Flash Lite 4

Retourneert een tekenreeksrepresentatie van het getal in exponentiële notatie. De tekenreeks bevat één cijfer voor het decimaalteken en maximaal 20 cijfers na het decimaalteken, zoals opgegeven in de parameter fractionDigits.

Parameters

fractionDigits:uint — Een geheel getal in het bereik van 0 tot en met 20, dat het gewenste aantal decimalen vertegenwoordigt.

Geretourneerde waarde

String

Gegenereerde uitzondering

RangeError — Genereert een uitzondering wanneer het argument fractionDigits buiten het bereik 0 tot 20 valt.

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt getoond hoe toExponential(2) een tekenreeks in exponentiële notatie retourneert.

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

toFixed

()

methode

AS3 function toFixed(fractionDigits:uint):String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 9, AIR 1.0, Flash Lite 4

Retourneert een tekenreeksrepresentatie van het getal in vaste-kommanotatie. Vaste-kommanotatie houdt in dat de tekenreeks een bepaald aantal cijfers na het decimaalteken zal bevatten, zoals opgegeven in de parameter fractionDigits. Het geldige bereik voor de parameter fractionDigits loopt van 0 tot en met 20. Wanneer u een waarde buiten dit bereik opgeeft, wordt een uitzondering gegenereerd.

Parameters

fractionDigits:uint — Een geheel getal in het bereik van 0 tot en met 20, dat het gewenste aantal decimalen vertegenwoordigt.

Geretourneerde waarde

String

Gegenereerde uitzondering

RangeError — Genereert een uitzondering wanneer het argument fractionDigits buiten het bereik 0 tot 20 valt.

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt getoond hoe toFixed(3) een tekenreeks retourneert die is afgerond op drie decimalen.

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

In het volgende voorbeeld wordt getoond hoe toFixed(2) een tekenreeks met navolgende nullen retourneert.

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

toPrecision

()

methode

AS3 function toPrecision(precision:uint):String

Taalversie:

ActionScript 3.0

Runtimeversies:

Flash Player 9, AIR 1.0, Flash Lite 4

Retourneert een tekenreeksrepresentatie van het getal in exponentiële notatie of vaste-kommanotatie. De tekenreeks zal het aantal cijfers bevatten dat is opgegeven in de parameter precision.

Parameters

precision:uint — Een geheel getal in het bereik van 1 tot en met 21, dat het gewenste aantal cijfers in de resulterende tekenreeks vertegenwoordigt.

Geretourneerde waarde

String

Gegenereerde uitzondering

RangeError — Genereert een uitzondering wanneer het argument precision buiten het bereik 1 tot 21 valt.

Voorbeeld ( Hoe dit voorbeeld te gebruiken )

In het volgende voorbeeld wordt getoond hoe toPrecision(3) een tekenreeks met slechts drie cijfers retourneert. De tekenreeks wordt in vaste-kommanotatie geretourneerd omdat exponentiële notatie niet nodig is.

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

In het volgende voorbeeld wordt getoond hoe toPrecision(3) een tekenreeks met slechts drie cijfers retourneert. De tekenreeks wordt in exponentiële notatie geretourneerd omdat onvoldoende cijfers beschikbaar zijn voor vaste-kommanotatie.

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

toString

()

methode

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

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert de tekenreeksrepresentatie van het opgegeven object Number (myNumber). Wanneer de waarde van het object Number een decimaal getal zonder een voorloopnul (zoals .4) is, wordt met Number.toString() een voorloopnul toegevoegd (0.4).

Parameters

radix:Number (default = 10) — Geeft het grondtal op (van 2 tot en met 36) dat voor de omzetting van getal in tekenreeks moet worden gebruikt. Wanneer u de parameter radix niet opgeeft, is de standaardwaarde 10.

Geretourneerde waarde

String — De numerieke representatie van het object Number als tekenreeks.

valueOf

()

methode

AS3 function valueOf():Number

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Retourneert het primitieve waardetype van het opgegeven object Number.

Geretourneerde waarde

Number — Het primitieve waardetype van het object Number.

Constantedetails

MAX_VALUE

Constante

public static const MAX_VALUE:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Het grootst mogelijke getal (IEEE-754 met dubbele precisie). Dit getal is ongeveer 1,79e+308.

MIN_VALUE

Constante

public static const MIN_VALUE:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Het kleinst mogelijke (het dichtst bij nul, niet het negatiefst) IEEE-754-getal dat niet gelijk is aan nul. Op de meeste platforms is dit getal ongeveer 5e-324, maar het kan groter zijn op systemen die geen gedenormaliseerde getallen ondersteunen. Op iOS bijvoorbeeld is de waarde van deze constante 2.225e-308.

Opmerking: het absolute kleinst mogelijke getal in het algemeen is -Number.MAX_VALUE.

NaN

Constante

public static const NaN:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

De IEEE-754-waarde die NaN (Not a Number) vertegenwoordigt.

Verwante API-elementen

isNaN() algemene functie

NEGATIVE_INFINITY

Constante

public static const NEGATIVE_INFINITY:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Geeft de IEEE-754-waarde op die negatief oneindig vertegenwoordigt. De waarde van deze eigenschap is gelijk aan die van de constante -Infinity.

Negatief oneindig is een speciale numerieke waarde die wordt geretourneerd wanneer een wiskundige bewerking of functie een negatieve waarde oplevert die groter is dan kan worden gerepresenteerd.

POSITIVE_INFINITY

Constante

public static const POSITIVE_INFINITY:Number

Taalversie:

ActionScript 3.0

Runtimeversies:

AIR 1.0, Flash Player 9, Flash Lite 4

Geeft de IEEE-754-waarde op die positief oneindig vertegenwoordigt. De waarde van deze eigenschap is gelijk aan die van de constante Infinity.

Positief oneindig is een speciale numerieke waarde die wordt geretourneerd wanneer een wiskundige bewerking of functie een waarde oplevert die groter is dan kan worden gerepresenteerd.

Voorbeelden Hoe dit voorbeeld te gebruiken

NumberExample.as

In het volgende voorbeeld wordt getoond hoe een getal met zes decimalen wordt afgekapt (met afronding) tot een getal met twee cijfers na het decimaalteken.

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

Juridische kennisgeving | Online privacybeleid

Number - AS3

Pakkettenx

Taalelementen

Bijlagen

Klassen x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY