Number (ActionScript 3.0)

	Eigenschaft	Definiert von
		constructor : Object Ein Verweis auf das Klassenobjekt oder die Konstruktorfunktion für eine angegebene Objektinstanz.	Object
		prototype : Object [static] Ein Verweis auf das Prototypobjekt einer Klasse oder eines Funktionsobjekts.	Object

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

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

Konstruktordetail

Number

()

Konstruktor

public function Number(num:Object)

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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).

Siehe auch

Number.toString()
Number.valueOf()
Beschreibung der Datentypen
Typumwandlungen

Methodendetail

toExponential

()

Methode

AS3 function toExponential(fractionDigits:uint):String

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

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

Player-Version :

Flash Player 9

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

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

Player-Version :

Flash Player 9

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

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

Player-Version :

Flash Player 9

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

Player-Version :

Flash Player 9

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

Rückgabewerte

Number — Der Grundwert dieses Number-Objekts.

Konstantendetail

MAX_VALUE

Konstante

public static const MAX_VALUE:Number

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

Player-Version :

Flash Player 9

Die kleinste darstellbare Zahl (IEEE-754, doppelt genau). Diese Zahl beträgt ungefähr 5E-324. Die kleinste darstellbare Zahl insgesamt ist -Number.MAX_VALUE.

NaN

Konstante

public static const NaN:Number

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

Siehe auch

isNaN()

NEGATIVE_INFINITY

Konstante

public static const NEGATIVE_INFINITY:Number

Sprachversion :

ActionScript 3.0

Player-Version :

Flash Player 9

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

Player-Version :

Flash Player 9

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 von Beispielen

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

Aktuelle Seite: http://livedocs.adobe.com/flash/9.0_de/ActionScriptLangRefV3/Number.html

Komponenten-Referenzhandbuch für ActionScript 3.0		Alle Pakete \| Alle Klassen \| Sprachelemente \| Stichwortverzeichnis \| Anhänge \| Konventionen \| Frames Keine Frames
Number	Eigenschaften \| Methoden \| Konstanten \| Beispiele

Paket	Oberste Ebene
Klasse	public final class Number
Vererbung	Number Object