Math - Adobe ActionScript® 3 (AS3 ) API-Referenz

Paket	Oberste Ebene
Klasse	public final class Math
Vererbung	Math Object

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Die Math-Klasse umfasst Methoden und Konstanten, die allgemeine mathematische Funktionen und Werte repräsentieren.

Verwenden Sie die Methoden und Eigenschaften dieser Klasse, um auf mathematische Konstanten und Funktionen zuzugreifen und diese zu bearbeiten. Alle Eigenschaften und Methoden der Math-Klasse sind statisch und müssen mit der Syntax Math.method( parameter ) oder Math.constant aufgerufen werden. In ActionScript sind Konstanten mit der maximalen Genauigkeit doppelt genauer Gleitkommazahlen nach IEEE-754 definiert.

Verschiedene Methoden der Math-Klasse verwenden als Parameter den Bogenmaßwert eines Winkels. Sie können die unten stehende Gleichung zur Berechnung von Bogenmaßwerten verwenden und den berechneten Wert als Parameter bereitstellen, oder Sie können die gesamte rechte Seite der Gleichung (bei der der Winkel in Bogenmaß anstelle von degrees angegeben ist) als Parameter für das Bogenmaß bereitstellen.

Bogenmaßwerte lassen sich wie folgt berechnen:

 radians = degrees * Math.PI/180

Um aus einem Bogenmaßwert die Gradzahl zu berechnen, verwenden Sie die folgende Formel:

 degrees = radians * 180/Math.PI

Im folgenden Beispiel wird die Gleichung als Parameter zum Berechnen des Sinus eines 45-Grad-Winkels übergeben:

Math.sin(45 * Math.PI/180) ist identisch mit Math.sin(.7854)

Hinweis: Die Math-Funktionen acos, asin, atan, atan2, cos, exp, log, pow, sin und sqrt können je nach Algorithmus, den die CPU oder das Betriebssystem verwendet, zu leicht abweichenden Ergebnissen führen. Flash-Laufzeitumgebungen nutzen die CPU (oder das Betriebssystem, falls die CPU keine Gleitkommaberechnungen unterstützt), wenn Berechnungen für die aufgezählten Funktionen durchzuführen sind, und die Ergebnisse haben je nach verwendeter CPU bzw. verwendetem Betriebssystem leichte Abweichungen aufgezeigt.

Ö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
		abs(val:Number):Number [statisch] Berechnet einen absoluten Wert für die im Parameter „val“ angegebene Zahl und gibt diesen zurück.	Math
		acos(val:Number):Number [statisch] Berechnet den Arkuskosinus für die im Parameter „val“ angegebene Zahl und gibt diesen in Bogenmaß zurück.	Math
		asin(val:Number):Number [statisch] Berechnet den Arkussinus für die im Parameter „val“ angegebene Zahl und gibt diesen in Bogenmaß zurück.	Math
		atan(val:Number):Number [statisch] Berechnet in Bogenmaß den Wert des Winkels, dessen Tangens durch den Parameter „val“ festgelegt ist.	Math
		atan2(y:Number, x:Number):Number [statisch] Berechnet den Winkel des Punktes „y/x“ in Bogenmaß, gegen den Uhrzeigersinn von der x-Achse eines Kreises aus gemessen (mit 0,0 als Mittelpunkt des Kreises).	Math
		ceil(val:Number):Number [statisch] Gibt die Obergrenze der angegebenen Zahl bzw. des angegebenen Ausdrucks zurück.	Math
		cos(angleRadians:Number):Number [statisch] Berechnet den Kosinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück.	Math
		exp(val:Number):Number [statisch] Gibt den Wert der Basis des natürlichen Logarithmus (e) potenziert mit dem im Parameter „x“ angegebenen Exponenten zurück.	Math
		floor(val:Number):Number [statisch] Gibt die Untergrenze der Zahl oder des Ausdrucks zurück, die bzw. der im Parameter „val“ angegeben ist.	Math
		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
		log(val:Number):Number [statisch] Gibt den natürlichen Logarithmus des Parameters „val“ zurück.	Math
		max(val1:Number, val2:Number, ... rest):Number [statisch] Wertet „val1“ und „val2“ (oder auch weitere Werte) aus und gibt den größten Wert zurück.	Math
		min(val1:Number, val2:Number, ... rest):Number [statisch] Wertet „val1“ und „val2“ (oder auch weitere Werte) aus und gibt den kleinsten Wert zurück.	Math
		pow(base:Number, pow:Number):Number [statisch] Berechnet und gibt „base“ hoch „pow“ zurück.	Math
		propertyIsEnumerable(name:String):Boolean Gibt an, ob die angegebene Eigenschaft vorhanden ist und durchlaufen werden kann.	Object
		random():Number [statisch] Gibt eine Pseudozufallszahl n zurück, wobei 0 <= n < 1.	Math
		round(val:Number):Number [statisch] Rundet den Wert des Parameters „val“ auf die nächstliegende Ganzzahl auf oder ab und gibt diese zurück.	Math
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void Legt die Verfügbarkeit einer dynamischen Eigenschaft für Schleifenoperationen fest.	Object
		sin(angleRadians:Number):Number [statisch] Berechnet den Sinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück.	Math
		sqrt(val:Number):Number [statisch] Berechnet die Quadratwurzel der angegebenen Zahl und gibt diese zurück.	Math
		tan(angleRadians:Number):Number [statisch] Berechnet den Tangens des angegebenen Winkels und gibt diesen zurück.	Math
		toLocaleString():String Gibt die Stringdarstellung dieses Objekts zurück, formatiert entsprechend den Konventionen des Gebietsschemas.	Object
		toString():String Gibt das angegebene Objekt als String zurück.	Object
		valueOf():Object Gibt den Grundwert des angegebenen Objekts zurück.	Object

Öffentliche Konstanten

	Konstante		Definiert von
		E : Number = 2.71828182845905 [statisch] Eine mathematische Konstante für die Basis des natürlichen Logarithmus, ausgedrückt als „e“.	Math
		LN10 : Number = 2.302585092994046 [statisch] Eine mathematische Konstante für den natürlichen Logarithmus von 10, der als „loge10“ ausgedrückt wird und den Näherungswert 2,302585092994046 aufweist.	Math
		LN2 : Number = 0.6931471805599453 [statisch] Eine mathematische Konstante für den natürlichen Logarithmus von 2, der als „loge2“ ausgedrückt wird und den Näherungswert 0,6931471805599453 aufweist.	Math
		LOG10E : Number = 0.4342944819032518 [statisch] Eine mathematische Konstante für den Logarithmus zur Basis 10 der Konstante e (Math.E), der als „log10e“ ausgedrückt wird und den Näherungswert 0,4342944819032518 aufweist.	Math
		LOG2E : Number = 1.442695040888963387 [statisch] Eine mathematische Konstante für den Zweierlogarithmus der Konstante e, der als „log2e“ ausgedrückt wird und den Näherungswert 1,442695040888963387 aufweist.	Math
		PI : Number = 3.141592653589793 [statisch] Eine mathematische Konstante für das Verhältnis des Umfangs eines Kreises zu seinem Durchmesser, der als Pi mit dem Wert 3,141592653589793 ausgedrückt wird.	Math
		SQRT1_2 : Number = 0.7071067811865476 [statisch] Eine mathematische Konstante für die Quadratwurzel von 1/2 mit dem Näherungswert 0,7071067811865476.	Math
		SQRT2 : Number = 1.4142135623730951 [statisch] Eine mathematische Konstante für die Quadratwurzel von 2 mit dem Näherungswert 1,4142135623730951.	Math

Methodendetails

abs

()

Methode

public static function abs(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet einen absoluten Wert für die im Parameter val angegebene Zahl und gibt diesen zurück.

Parameter

val:Number — Die Zahl, deren absoluter Wert zurückgegeben wird.

Rückgabewerte

Number — Der absolute Wert des angegebenen Parameters.

acos

()

Methode

public static function acos(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet den Arkuskosinus für die im Parameter val angegebene Zahl und gibt diesen in Bogenmaß zurück.

Parameter

val:Number — Eine Zahl zwischen -1,0 und 1,0.

Rückgabewerte

Number — Der Arkuskosinus des Parameters val.

asin

()

Methode

public static function asin(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet den Arkussinus für die im Parameter val angegebene Zahl und gibt diesen in Bogenmaß zurück.

Parameter

val:Number — Eine Zahl zwischen -1,0 und 1,0.

Rückgabewerte

Number — Eine Zahl zwischen negativ Pi dividiert durch 2 und positiv Pi dividiert durch 2.

atan

()

Methode

public static function atan(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet den Wert des Winkels, dessen Tangens durch den Parameter val festgelegt ist, in Bogenmaß. Der Rückgabewert liegt zwischen negativ Pi dividiert durch 2 und positiv Pi dividiert durch 2.

Parameter

val:Number — Eine Zahl, die den Tangens eines Winkels angibt.

Rückgabewerte

Number — Eine Zahl zwischen negativ Pi dividiert durch 2 und positiv Pi dividiert durch 2.

atan2

()

Methode

public static function atan2(y:Number, x:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet den Winkel des Punktes y/x in Bogenmaß, von der x-Achse eines Kreises aus gegen den Uhrzeigersinn gemessen (mit 0,0 als Mittelpunkt des Kreises). Der Rückgabewert liegt zwischen positiv Pi und negativ Pi. Der erste Parameter von atan2 ist immer die y-Koordinate.

Parameter

	`y:Number` — Die y-Koordinate des Punkts.

	`x:Number` — Die x-Koordinate des Punkts.

Rückgabewerte

Number — Eine Zahl.

Verwandte API-Elemente

Math.acos()
Math.asin()
Math.atan()
Math.cos()
Math.sin()
Math.tan()

ceil

()

Methode

public static function ceil(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Obergrenze der angegebenen Zahl bzw. des angegebenen Ausdrucks zurück. Die Obergrenze einer Zahl ist die nächstliegende Ganzzahl, die größer oder gleich der Zahl ist.

Parameter

val:Number — Eine Zahl oder ein Ausdruck.

Rückgabewerte

Number — Die Ganzzahl, die dem Parameter val am Nächsten liegt und gleichzeitig größer oder gleich diesem Parameter ist.

Verwandte API-Elemente

Math.floor()
Math.round()

cos

()

Methode

public static function cos(angleRadians:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet den Kosinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück. Informationen zum Berechnen eines Bogenmaßes finden Sie in der Einführung zur Math-Klasse.

Parameter

angleRadians:Number — Eine Zahl, die einen Winkel in Bogenmaß angibt.

Rückgabewerte

Number — Eine Zahl zwischen -1,0 und 1,0.

Verwandte API-Elemente

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.sin()
Math.tan()

exp

()

Methode

public static function exp(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den Wert der Basis des natürlichen Logarithmus (e) potenziert mit dem im Parameter x angegebenen Exponenten zurück. Die Konstante Math.E kann den Wert von e liefern.

Parameter

val:Number — Der Exponent. Eine Zahl oder ein Ausdruck.

Rückgabewerte

Number — e hoch val.

Verwandte API-Elemente

Math.E

floor

()

Methode

public static function floor(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt die Untergrenze der Zahl oder des Ausdrucks zurück, die bzw. der im Parameter val angegeben ist. Die Untergrenze einer Zahl ist die nächstliegende Ganzzahl, die kleiner oder gleich der angegebenen Zahl bzw. dem angegebenen Ausdruck ist.

Parameter

val:Number — Eine Zahl oder ein Ausdruck.

Rückgabewerte

Number — Die Ganzzahl, die dem Parameter val am Nächsten liegt und gleichzeitig kleiner oder gleich diesem Parameter ist.

log

()

Methode

public static function log(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt den natürlichen Logarithmus des Parameters val zurück.

Parameter

val:Number — Eine Zahl oder ein Ausdruck mit einem Wert größer als 0.

Rückgabewerte

Number — Der natürliche Logarithmus des Parameters val.

max

()

Methode

public static function max(val1:Number, val2:Number, ... rest):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Wertet val1 und val2 (oder auch weitere Werte) aus und gibt den größten Wert zurück.

Parameter

	`val1:Number` — Eine Zahl oder ein Ausdruck.

	`val2:Number` — Eine Zahl oder ein Ausdruck.

	`... rest` — Eine Zahl oder ein Ausdruck. `Math.max()` kann mehrere Argumente akzeptieren.

Rückgabewerte

Number — Der größte Wert der Parameter val1 und val2 (und gegebenenfalls weiterere Werte).

Verwandte API-Elemente

Math.min()

min

()

Methode

public static function min(val1:Number, val2:Number, ... rest):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Wertet val1 und val2 (oder auch weitere Werte) aus und gibt den kleinsten Wert zurück.

Parameter

	`val1:Number` — Eine Zahl oder ein Ausdruck.

	`val2:Number` — Eine Zahl oder ein Ausdruck.

	`... rest` — Eine Zahl oder ein Ausdruck. `Math.min()` kann mehrere Argumente akzeptieren.

Rückgabewerte

Number — Der kleinste Wert der Parameter val1 und val2 (und gegebenenfalls weiterere Werte).

Verwandte API-Elemente

Math.max()

pow

()

Methode

public static function pow(base:Number, pow:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet und gibt den Wert base hoch pow zurück.

Parameter

	`base:Number` — Eine Zahl, die mit dem Parameter `pow` potenziert werden soll.

	`pow:Number` — Eine Zahl, die angibt, mit welchem Exponenten der Parameter `base` potenziert wird.

Rückgabewerte

Number — Der Wert von base erhöht auf die Potenz von pow.

random

()

Methode

public static function random():Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Gibt eine Pseudozufallszahl n zurück, wobei 0 <= n < 1. Wie die zurückgegebene Zahl berechnet wird, wird nicht bekannt gegeben. Man spricht von einer „Pseudo-Zufallszahl“, da es unvermeidlich ist, dass die Berechnung einige nicht-zufällige Elemente enthält.

Rückgabewerte

Number — Eine Pseudozufallszahl.

Verwandte API-Elemente

flash.crypto.generateRandomBytes()

round

()

Methode

public static function round(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Rundet den Wert des Parameters val auf die nächstliegende Ganzzahl auf oder ab und gibt diese zurück. Hat val den gleichen Abstand von den beiden nächstliegenden Ganzzahlen (z. B. Zahlen die mit .5 enden), wird der Wert auf die nächsthöhere Ganzzahl aufgerundet.

Parameter

val:Number — Die Zahl, die gerundet werden soll.

Rückgabewerte

Number — Der auf die nächste Ganzzahl gerundete Parameter val.

Verwandte API-Elemente

Math.ceil()
Math.floor()

sin

()

Methode

public static function sin(angleRadians:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet den Sinus des angegebenen Winkels und gibt den Wert in Bogenmaß zurück. Informationen zum Berechnen eines Bogenmaßes finden Sie in der Einführung zur Math-Klasse.

Parameter

angleRadians:Number — Eine Zahl, die einen Winkel in Bogenmaß angibt.

Rückgabewerte

Number — Ein Zahl, der Sinus des angegebenen Winkels (zwischen -1,0 und 1,0).

Verwandte API-Elemente

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.cos()
Math.tan()

sqrt

()

Methode

public static function sqrt(val:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet die Quadratwurzel der angegebenen Zahl und gibt diese zurück.

Parameter

val:Number — Eine Zahl oder ein Ausdruck größer oder gleich 0.

Rückgabewerte

Number — Eine Zahl, wenn der Parameter val größer oder gleich Null ist; andernfalls NaN (Not a Number ߝ keine Zahl).

tan

()

Methode

public static function tan(angleRadians:Number):Number

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Berechnet den Tangens des angegebenen Winkels und gibt diesen zurück. Informationen zum Berechnen eines Bogenmaßes finden Sie in der Einführung zur Math-Klasse.

Parameter

angleRadians:Number — Eine Zahl, die einen Winkel in Bogenmaß angibt.

Rückgabewerte

Number — Der Tangens des Parameters angleRadians.

Verwandte API-Elemente

Math.acos()
Math.asin()
Math.atan()
Math.atan2()
Math.cos()
Math.sin()

Konstantendetails

E

Konstante

public static const E:Number = 2.71828182845905

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für die Basis des natürlichen Logarithmus, ausgedrückt als e. Der ungefähre Wert von e ist 2,71828182845905.

LN10

Konstante

public static const LN10:Number = 2.302585092994046

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für den natürlichen Logarithmus von 10, der als log_e10 ausgedrückt wird und den Näherungswert 2,302585092994046 aufweist.

LN2

Konstante

public static const LN2:Number = 0.6931471805599453

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für den natürlichen Logarithmus von 2, der als log_e2 ausgedrückt wird und den Näherungswert 0,6931471805599453 aufweist.

LOG10E

Konstante

public static const LOG10E:Number = 0.4342944819032518

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für den Zehnerlogarithmus der Konstante e (Math.E), der als log₁₀e ausgedrückt wird und den Näherungswert 0,4342944819032518 aufweist.

Die Math.log()-Methode berechnet den natürlichen Logarithmus einer Zahl. Den Zehnerlogarithmus erhalten Sie, indem Sie das Ergebnis von Math.log() mit Math.LOG10E multiplizieren.

LOG2E

Konstante

public static const LOG2E:Number = 1.442695040888963387

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für den Zweierlogarithmus der Konstante e, der als „log2e“ ausgedrückt wird und den Näherungswert 1,442695040888963387 aufweist.

Die Math.log-Methode berechnet den natürlichen Logarithmus einer Zahl. Den Zweierlogarithmus erhalten Sie, indem Sie das Ergebnis von Math.log() mit Math.LOG2E multiplizieren.

PI

Konstante

public static const PI:Number = 3.141592653589793

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für das Verhältnis des Umfangs eines Kreises zu seinem Durchmesser, der als Pi mit dem Wert 3,141592653589793 ausgedrückt wird.

SQRT1_2

Konstante

public static const SQRT1_2:Number = 0.7071067811865476

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für die Quadratwurzel von 1/2 mit dem Näherungswert 0,7071067811865476.

SQRT2

Konstante

public static const SQRT2:Number = 1.4142135623730951

Sprachversion:

ActionScript 3.0

Laufzeitversionen:

AIR 1.0, Flash Player 9, Flash Lite 4

Eine mathematische Konstante für die Quadratwurzel von 2 mit dem Näherungswert 1,4142135623730951.

Rechtliche Hinweise | Onlinedatenschutzerklärung

Math - AS3

Klassen x

abs

acos

asin

atan

atan2

ceil

cos

exp

floor

log

max

min

pow

random

round

sin

sqrt

tan

E

LN10

LN2

LOG10E

LOG2E

PI

SQRT1_2

SQRT2