Number

Paket	Oberste Ebene
Klasse	public final class Number
Vererbung	Number Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Ein Datentyp, der eine Gleitkommazahl nach IEEE -754 mit doppelter Genauigkeit repräsentiert. Sie können Grundwerte manipulieren, indem Sie die der Number-Klasse zugeordneten Methoden und Eigenschaften verwenden. Diese Klasse ist mit der Number-Klasse in JavaScript identisch.

Die Eigenschaften der Number-Klasse sind statisch, d. h., Sie können sie verwenden, ohne dass ein Objekt nötig ist. Somit ist kein Konstruktor erforderlich.

Der Datentyp Number hält sich an den IEEE-754-Standard (doppelt genau).

Der Datentyp Number ist nützlich, wenn Sie Gleitkommawerte verwenden müssen. Flash-Laufzeitumgebungen behandeln die Datentypen int und uint effektiver als Number, doch ist Number praktisch in Situationen, in denen der erforderliche Wertebereich den Wertebereich der Datentypen int und uint überschreitet. Die Number-Klasse kann zur Darstellung von Ganzzahlwerten verwendet werden, die weit über den gültigen Bereich der Datentypen int und uint hinausgehen. Der Datentyp Number kann bis zu 53 Bits verwenden, um ganzzahlige Werte darzustellen, im Gegensatz zu 32 Bits bei int und uint. Der Standardwert einer als Number eingegebenen Variable ist NaN (Not a Number, keine Zahl).

Beispiele anzeigen

Verwandte API-Elemente

int
uint

Öffentliche Eigenschaften

Vererbte öffentliche Eigenschaften ausblenden

Vererbte öffentliche Eigenschaften anzeigen

	Eigenschaft		Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object

Öffentliche Methoden

Vererbte öffentliche Methoden ausblenden

Vererbte öffentliche Methoden anzeigen

	Methode		Definiert von
		Number(num:Object) Erstellt ein Number-Objekt mit dem angegebenen Wert.	Number
		hasOwnProperty(name:String):Boolean Gibt an, ob für ein Objekt eine bestimmte Eigenschaft definiert wurde.	Object
		isPrototypeOf(theClass:Object):Boolean Gibt an, ob eine Instanz der Object-Klasse in der Prototypkette des Objekts vorhanden ist, das als Parameter angegeben wurde.	Object
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		toExponential(fractionDigits:uint):String Gibt eine Zahl in Exponentialschreibweise als String zurück.	Number
		toFixed(fractionDigits:uint):String Gibt eine Zahl in Festkommaschreibweise als String zurück.	Number
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toPrecision(precision:uint):String Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück.	Number
		toString(radix:Number = 10):String Gibt das angegebene Number-Objekt (myNumber) als String zurück.	Number
		valueOf():Number Gibt den Grundwerttyp des angegebenen Number-Objekts zurück.	Number

Öffentliche Konstanten

	Konstante		Definiert von
		MAX_VALUE : Number [statisch] Die größte darstellbare Zahl (IEEE-754, doppelt genau).	Number
		MIN_VALUE : Number [statisch] Die kleinste (null am nächsten, nicht größte negative) darstellbare Zahl nach IEEE-754, die nicht auf null vergleicht.	Number
		NaN : Number [statisch] Der Wert für NaN (Not A Number, keine Zahl) nach IEEE-754.	Number
		NEGATIVE_INFINITY : Number [statisch] Gibt den IEEE-754-Wert an, der für negative Unendlichkeit steht.	Number
		POSITIVE_INFINITY : Number [statisch] Gibt den IEEE-754-Wert an, der für positive Unendlichkeit steht.	Number

Konstruktordetails

()

Konstruktor

public function Number(num:Object)

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Erstellt ein Number-Objekt mit dem angegebenen Wert. Dieser Konstruktor hat denselben Effekt wie die native public-Funktion Number(), mit der ein Objekt eines anderen Typs in einen numerischen Grundwert umgewandelt wird.

Parameter

num:Object — Der numerische Wert der zu erstellenden Number-Instanz oder ein Wert, der in eine Zahl umgewandelt werden soll. Der Standardwert ist 0, wenn num nicht angegeben wird. Den Konstruktor ohne num-Parameter zu verwenden ist nicht dasselbe wie die Deklaration einer Variable vom Typ Number, ohne ihr einen Wert zuzuweisen (z. B. var myNumber:Number), wobei der Standardwert NaN ist. Eine Zahl ohne zugewiesenen Wert ist nicht definiert und ist ein Äquivalent zu new Number(undefined).

Verwandte API-Elemente

Number.toString()
Number.valueOf()

Methodendetails

toExponential

()

Methode

AS3 function toExponential(fractionDigits:uint):String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 9, AIR 1.0, Flash Lite 4

Gibt eine Zahl in Exponentialschreibweise als String zurück. Der String enthält eine Ziffer vor der Dezimalstelle und bis zu 20 Nachkommastellen, gemäß der Angabe im Parameter fractionDigits.

Parameter

fractionDigits:uint — Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert.

Rückgabewerte

String

Auslöser

RangeError — Löst eine Ausnahme aus, wenn das Argument fractionDigits nicht zwischen 0 und 20 liegt.

Beispiel ( Verwendung dieses Beispiels )

Das folgende Beispiel zeigt die Rückgabe eines Strings in Exponentialschreibweise durch toFixed(2).

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

toFixed

()

Methode

AS3 function toFixed(fractionDigits:uint):String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 9, AIR 1.0, Flash Lite 4

Gibt eine Zahl in Festkommaschreibweise als String zurück. Festkommaschreibweise bedeutet, dass der String eine bestimmte Anzahl an Nachkommastellen enthält, und zwar gemäß der Angabe im Parameter fractionDigits. Die zulässigen Werte für den Parameter fractionDigits liegen zwischen 0 und 20. Wird ein Wert außerhalb dieses Bereichs angegeben, wird eine Ausnahme ausgelöst.

Parameter

fractionDigits:uint — Eine Ganzzahl zwischen 0 und 20 (einschließlich), die die gewünschte Anzahl an Dezimalstellen repräsentiert.

Rückgabewerte

String

Auslöser

RangeError — Löst eine Ausnahme aus, wenn das Argument fractionDigits nicht zwischen 0 und 20 liegt.

Beispiel ( Verwendung dieses Beispiels )

Das folgende Beispiel zeigt die Rückgabe eines Strings durch toFixed(3), mit dem auf drei Dezimalstellen aufgerundet wird.

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

Das folgende Beispiel zeigt die Rückgabe eines Strings durch toFixed(2), mit dem nachgestellte Nullen hinzugefügt werden.

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

toPrecision

()

Methode

AS3 function toPrecision(precision:uint):String

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

Flash Player 9, AIR 1.0, Flash Lite 4

Gibt eine Zahl in Exponential- oder Festkommaschreibweise als String zurück. Der String enthält die im Parameter precision angegebene Anzahl an Ziffern.

Parameter

precision:uint — Eine Ganzzahl zwischen 1 und 21 (einschließlich), die die gewünschte Anzahl an Nachkommastellen für die Darstellung des Strings repräsentiert.

Rückgabewerte

String

Auslöser

RangeError — Löst eine Ausnahme aus, wenn das Argument precision nicht zwischen 1 und 21 liegt.

Beispiel ( Verwendung dieses Beispiels )

Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch toFixed(3). Der String wird in Festkommaschreibweise zurückgegeben, da Exponentialschreibweise nicht erforderlich ist.

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

Das folgende Beispiel zeigt die Rückgabe eines Strings mit nur drei Stellen durch toFixed(3). Der String wird in Exponentialschreibweise zurückgegeben, da die Anzahl an Stellen der sich ergebenden Zahl nicht ausreichen für die Festkommaschreibweise.

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

toString

()

Methode

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

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt das angegebene Number-Objekt (myNumber) als Zeichenfolge zurück. Ist der Wert des Number-Objekts eine Dezimalzahl ohne führende Null (z. B. .4), fügt Number.toString() die führende Null hinzu (0.4).

Parameter

radix:Number (default = 10) — Gibt die numerische Basis (von 2 bis 36) an, die bei der Umwandlung von Zahlen in Strings verwendet werden soll. Wenn Sie den Parameter radix nicht angeben, wird als Standardwert 10 verwendet.

Rückgabewerte

String — Die numerische Repräsentation des Number-Objekts als String.

valueOf

()

Methode

AS3 function valueOf():Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den Grundwerttyp des angegebenen Number-Objekts zurück.

Rückgabewerte

Number — Der Grundwert dieses Number-Objekts.

Konstantendetails

MAX_VALUE

Konstante

public static const MAX_VALUE:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die größte darstellbare Zahl (IEEE-754, doppelt genau). Diese Zahl lautet ungefähr 1.79E+308.

MIN_VALUE

Konstante

public static const MIN_VALUE:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die kleinste (null am nächsten, nicht größte negative) darstellbare Zahl nach IEEE-754, die nicht auf null vergleicht. Bei den meisten Plattformen entspricht diese Zahl ungefähr 5e-324, kann jedoch auf Systemen, die keine denormalisierten Zahlen unterstützen, größer sein. Beispielsweise ist der Wert dieser Konstante unter iOS 2.225e-308.

Hinweis: Die absolute kleinste darstellbare Zahl insgesamt ist -Number.MAX_VALUE.

NaN

Konstante

public static const NaN:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Der Wert für NaN (Not A Number, keine Zahl) nach IEEE-754.

Verwandte API-Elemente

isNaN() globale Funktion

NEGATIVE_INFINITY

Konstante

public static const NEGATIVE_INFINITY:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den IEEE-754-Wert an, der für negative Unendlichkeit steht. Der Wert dieser Eigenschaft ist identisch mit dem der Konstanten -Infinity.

Negative Unendlichkeit ist ein spezieller numerischer Wert, der zurückgegeben wird, wenn eine mathematische Operation oder Funktion einen negativen Wert zurückgibt, der außerhalb des darstellbaren Bereichs liegt.

POSITIVE_INFINITY

Konstante

public static const POSITIVE_INFINITY:Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den IEEE-754-Wert an, der für positive Unendlichkeit steht. Der Wert dieser Eigenschaft ist identisch mit dem der Konstanten Infinity.

Positive Unendlichkeit ist ein spezieller numerischer Wert, der zurückgegeben wird, wenn eine mathematische Operation oder Funktion einen positiven Wert zurückgibt, der außerhalb des darstellbaren Bereichs liegt.

Beispiele Verwendung dieses Beispiels

NumberExample.as

Das folgende Beispiel veranschaulicht, wie eine Zahl mit sechs Nachkommastellen durch Abrunden auf eine Zahl mit zwei Nachkommastellen verkürzt wird.

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

Rechtliche Hinweise | Onlinedatenschutzerklärung

Number - AS3

Klassen x

Number

toExponential

toFixed

toPrecision

toString

valueOf

MAX_VALUE

MIN_VALUE

NaN

NEGATIVE_INFINITY

POSITIVE_INFINITY