Math - Adobe ActionScript® 3 (AS3 ) API 參考

套件	最上層
類別	public final class Math
繼承	Math Object

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

Math 類別包含了代表常用數學函數與值的方法和常數。

您可以使用這個類別的方法和屬性來存取及操作數學常數和函數。 Math 類別的所有屬性和方法都是靜態的，必須使用 Math.method( parameter ) 或 Math.constant 的語法來呼叫。在 ActionScript 中，常數定義為具有雙精度 IEEE-754 浮點數的最大精確度。

許多 Math 類別方法都會以夾角的度量 (以弧度為單位) 做為參數。您可以使用下列方程式在呼叫方法之前計算弧度值，然後提供計算出的值做為參數，或是可以提供方程式的整個右側 (以角度為單位的角度量來取代 degrees) 做為弧度參數。

若要計算弧度值，請使用下列公式：

 radians = degrees * Math.PI/180

若要從弧度計算角度，請使用下列公式：

 degrees = radians * 180/Math.PI

下面這個範例會將方程式當做參數傳遞，以便計算 45 度角的正弦值：

Math.sin(45 * Math.PI/180) 相同於 Math.sin(.7854)

注意：視 CPU 或作業系統所使用的演算法而定，Math 函數 acos、asin、atan、atan2、cos、exp、log、pow、sin 及 sqrt 可能得出稍微不同的值。執行上述函數的計算時，Flash 執行階段會呼叫 CPU (如果 CPU 不支援浮點計算，則會呼叫作業系統)，而且視使用的 CPU 或作業系統而定，顯示的結果將會稍有不同。

公用屬性

隱藏繼承公用屬性

顯示繼承公用屬性

	屬性		定義自
		constructor : Object 類別物件的參照或是特定物件實體的建構函數。	Object

公用方法

隱藏繼承公用方法

顯示繼承公用方法

	方法		定義自
		abs(val:Number):Number [靜態] 計算並傳回參數 val 所指定之數字的絕對值。	Math
		acos(val:Number):Number [靜態] 計算並傳回參數 val 中指定之數字的反餘弦值，以弧度為單位。	Math
		asin(val:Number):Number [靜態] 計算並傳回參數 val 中指定之數字的反正弦值，以弧度為單位。	Math
		atan(val:Number):Number [靜態] 計算並傳回參數 val 中指定的正切夾角值，以弧度為單位。	Math
		atan2(y:Number, x:Number):Number [靜態] 從圓的 x 軸 (其中 0,0 代表圓心) 以逆時針方向測量，計算並傳回 y/x 點的角度值，以弧度為單位。	Math
		ceil(val:Number):Number [靜態] 會傳回指定之數字或運算式的上限。	Math
		cos(angleRadians:Number):Number [靜態] 會計算及傳回指定之角度的餘弦 (以弧度為單位)。	Math
		exp(val:Number):Number [靜態] 傳回自然對數之底數 (e) 的次方值，此值是參數 x 中指定的指數。	Math
		floor(val:Number):Number [靜態] 會傳回 val 參數中指定之數字或運算式的上限。	Math
		hasOwnProperty(name:String):Boolean 指出物件是否有已定義的指定屬性。	Object
		isPrototypeOf(theClass:Object):Boolean 指出 Object 類別的實體是否位於指定為參數的物件原型鏈中。	Object
		log(val:Number):Number [靜態] 傳回參數 val 的自然對數。	Math
		max(val1:Number, val2:Number, ... rest):Number [靜態] 評估 val1 與 val2 (或更多值) 並傳回最大的值。	Math
		min(val1:Number, val2:Number, ... rest):Number [靜態] 評估 val1 與 val2 (或更多值) 並傳回最小的值。	Math
		pow(base:Number, pow:Number):Number [靜態] 計算並傳回底的 pow 次方。	Math
		propertyIsEnumerable(name:String):Boolean 指出指定的屬性是否存在，以及是否可列舉。	Object
		random():Number [靜態] 傳回虛擬亂數 n，其中 0 <= n < 1。	Math
		round(val:Number):Number [靜態] 將參數 val 的值四捨五入成最接近的整數，並傳回該值。	Math
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 為迴圈作業設定動態屬性的可用性。	Object
		sin(angleRadians:Number):Number [靜態] 會計算及傳回指定之角度的正弦 (以弧度為單位)。	Math
		sqrt(val:Number):Number [靜態] 會計算及傳回指定之數字的平方根。	Math
		tan(angleRadians:Number):Number [靜態] 會計算及傳回指定之角度的正切值。	Math
		toLocaleString():String 傳回代表此物件的字串，根據地區特定慣例進行格式化。	Object
		toString():String 會傳回指定之物件的字串形式。	Object
		valueOf():Object 會傳回指定之物件的基本值。	Object

公用常數

	常數		定義自
		E : Number = 2.71828182845905 [靜態] 代表自然對數之底數的數學常數，以 e 表示。	Math
		LN10 : Number = 2.302585092994046 [靜態] 數學常數；代表 10 的自然對數，以 loge10 來表示，近似值為 2.302585092994046。	Math
		LN2 : Number = 0.6931471805599453 [靜態] 數學常數；代表 2 的自然對數，以 loge2 來表示，近似值為 0.6931471805599453。	Math
		LOG10E : Number = 0.4342944819032518 [靜態] 數學常數，代表以 10 為底的常數 e (Math.E) 對數，以 log10e 表示，近似值為 0.4342944819032518。	Math
		LOG2E : Number = 1.442695040888963387 [靜態] 代表常數 e 對數 (以 2 為底) 的數學常數，以 log2e 表示，其近似值為 1.442695040888963387。	Math
		PI : Number = 3.141592653589793 [靜態] 代表圓周與直徑之比例的數學常數，以 pi 來表示，其值為 3.141592653589793。	Math
		SQRT1_2 : Number = 0.7071067811865476 [靜態] 代表 1/2 之平方根的數學常數，近似值為 0.7071067811865476。	Math
		SQRT2 : Number = 1.4142135623730951 [靜態] 代表 2 之平方根的數學常數，近似值為 1.4142135623730951。	Math

方法詳細資訊

abs

()

方法

public static function abs(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算並傳回參數 val 所指定之數字的絕對值。

參數

val:Number — 傳回其絕對值的數字。

傳回值

Number — 指定之參數的絕對值。

acos

()

方法

public static function acos(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算並傳回參數 val 中指定之數字的反餘弦值，以弧度為單位。

參數

val:Number — 從 -1.0 到 1.0 的數字。

傳回值

Number — val 參數的反餘弦值。

asin

()

方法

public static function asin(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算並傳回參數 val 中指定之數字的反正弦值，以弧度為單位。

參數

val:Number — 從 -1.0 到 1.0 的數字。

傳回值

Number — 介於負 pi 除以 2 與正 pi 除以 2 之間的數字。

atan

()

方法

public static function atan(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算並傳回參數 val 中所指定之正切值的角度值，以弧度為單位。傳回值範圍介於負 pi 除以 2 與正 pi 除以 2 之間。

參數

val:Number — 數字，代表某個夾角的正切值。

傳回值

Number — 介於負 pi 除以 2 與正 pi 除以 2 之間的數字。

atan2

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會從圓的 x 軸 (其中 0,0 代表圓心) 逆時針測量，然後計算並傳回 y/x 點的角度 (以弧度為單位)。傳回值介於正 pi 與負 pi 之間。請注意，atan2 的第一個參數永遠都是 y 座標。

參數

	`y:Number` — 點的 y 座標。

	`x:Number` — 點的 x 座標。

傳回值

Number — 數字。

ceil

()

方法

public static function ceil(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會傳回指定之數字或運算式的上限。一個數字的最小整數是指大於或等於該數字的最接近整數。

參數

val:Number — 數字或運算式。

傳回值

Number — 最接近且大於或等於 val 參數的整數。

相關 API 元素

Math.floor()
Math.round()

cos

()

方法

public static function cos(angleRadians:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算及傳回指定之角度的餘弦 (以弧度為單位)。若要計算弧度，請參閱 Math 類別的概觀。

參數

angleRadians:Number — 代表以弧度測量之角度的數字。

傳回值

Number — 從 -1.0 到 1.0 的數字。

exp

()

方法

public static function exp(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

傳回自然對數之底數 (e) 的次方值，此值是參數 x 中指定的指數。常數 Math.E 可提供 e 的值。

參數

val:Number — 指數；數字或運算式。

傳回值

Number — e 的次方 (val 參數) 值。

相關 API 元素

Math.E

floor

()

方法

public static function floor(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會傳回 val 參數中指定之數字或運算式的上限。最大整數是指小於或等於指定數字或運算式的最接近整數。

參數

val:Number — 數字或運算式。

傳回值

Number — 最接近且小於或等於 val 參數的整數。

log

()

方法

public static function log(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會傳回參數 val 的自然對數。

參數

val:Number — 值大於 0 的數字或運算式。

傳回值

Number — val 參數的自然對數。

max

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會評估 val1 與 val2 (或其他更多值) 並傳回最大的值。

參數

	`val1:Number` — 數字或運算式。

	`val2:Number` — 數字或運算式。

	`... rest` — 數字或運算式。 `Math.max()` 可接受多個引數。

傳回值

Number — 參數 val1 與 val2 (或其他更多值) 的最大值。

相關 API 元素

Math.min()

min

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會評估 val1 與 val2 (或其他更多值) 並傳回最小的值。

參數

	`val1:Number` — 數字或運算式。

	`val2:Number` — 數字或運算式。

	`... rest` — 數字或運算式。 `Math.min()` 可接受多個引數。

傳回值

Number — 參數 val1 與 val2 (或其他更多值) 的最小值。

相關 API 元素

Math.max()

pow

()

方法

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

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

計算並傳回 base 的 pow 次方的值。

參數

	`base:Number` — 要做為參數 `pow` 次方之底的數字。

	`pow:Number` — 要做為參數 `base` 底之次方的數字。

傳回值

Number — base 的 pow 次方的值。

random

()

方法

public static function random():Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

傳回虛擬亂數 n，其中 0 <= n < 1。傳回的數字是以未公開方式計算而且是「虛擬亂數」，因為計算必定會包含某些非亂數元素。

傳回值

Number — 虛擬亂數。

相關 API 元素

flash.crypto.generateRandomBytes()

round

()

方法

public static function round(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

將 val 參數的值四捨五入成最接近的整數，並傳回該值。如果 val 與其最接近的兩個整數彼此的差距相等 (也就是說，尾數為 .5)，則該值會四捨五入為下一個較高的整數。

參數

val:Number — 要四捨五入的數字。

傳回值

Number — 參數 val 四捨五入為最接近的整數。

相關 API 元素

Math.ceil()
Math.floor()

sin

()

方法

public static function sin(angleRadians:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算及傳回指定之角度的正弦 (以弧度為單位)。若要計算弧度，請參閱 Math 類別的概觀。

參數

angleRadians:Number — 代表以弧度測量之角度的數字。

傳回值

Number — 數字；指定夾角的正弦值 (介於 -1.0 與 1.0 之間)。

sqrt

()

方法

public static function sqrt(val:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算及傳回指定之數字的平方根。

參數

val:Number — 大於或等於 0 的數字或運算式。

傳回值

Number — 如果 val 參數大於或等於零則為數字，否則為 NaN (非數字)。

tan

()

方法

public static function tan(angleRadians:Number):Number

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

會計算及傳回指定之角度的正切值。若要計算弧度，請參閱 Math 類別的概觀。

參數

angleRadians:Number — 代表以弧度測量之角度的數字。

傳回值

Number — angleRadians 參數的正切值。

常數詳細資訊

E

常數

public static const E:Number = 2.71828182845905

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

代表自然對數之底數的數學常數，以 e 表示。 e 的近似值為 2.71828182845905。

LN10

常數

public static const LN10:Number = 2.302585092994046

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

數學常數，代表 10 的自然對數，以 log_e10 表示，近似值為 2.302585092994046。

LN2

常數

public static const LN2:Number = 0.6931471805599453

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

數學常數，代表 10 的自然對數，以 log_e 2 來表示，近似值為 0.6931471805599453。

LOG10E

常數

public static const LOG10E:Number = 0.4342944819032518

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

這個數學常數代表以 10 為底的常數 e ( Math.E )，表示為 ₁₀ e 對數，其近似值為 0.4342944819032518。

Math.log() 方法會計算數字的自然對數。只要將 Math.log() 的結果乘以 Math.LOG10E，便可取得以 10 為底的對數。

LOG2E

常數

public static const LOG2E:Number = 1.442695040888963387

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

代表常數 e 對數 (以 2 為底) 的數學常數，以 log2e 表示，其近似值為 1.442695040888963387。

Math.log 方法會計算數字的自然對數。只要將 Math.log() 的結果乘以 Math.LOG2E，便可取得以 2 為底的對數。

PI

常數

public static const PI:Number = 3.141592653589793

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

代表圓周與直徑之比例的數學常數，以 pi 來表示，其值為 3.141592653589793。

SQRT1_2

常數

public static const SQRT1_2:Number = 0.7071067811865476

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

代表 1/2 之平方根的數學常數，近似值為 0.7071067811865476。

SQRT2

常數

public static const SQRT2:Number = 1.4142135623730951

語言版本:

ActionScript 3.0

執行階段版本:

AIR 1.0, Flash Player 9, Flash Lite 4

代表 2 之平方根的數學常數，近似值為 1.4142135623730951。

法律聲明 | 線上隱私權政策

Math - AS3

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