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 [静态] 以弧度为单位计算并返回点 y/x 的角度值，该角度从圆的 x 轴（其中，0,0 表示圆心）沿逆时针方向测量。	Math
		ceil(val:Number):Number [静态] 返回指定数字或表达式的上限值。	Math
		cos(angleRadians:Number):Number [静态] 以弧度为单位计算并返回指定角度的余弦值。	Math
		exp(val:Number):Number [静态] 返回自然对数的底 (e) 的 x 次幂的值，x 由参数 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 [静态] 计算并返回 base 的 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 [静态] 代表常数 e (Math.E) 以 10 为底的对数的数学常数，表示为 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 和正二分之 pi 之间的一个数字。

atan

()

方法

public static function atan(val:Number):Number

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

以弧度为单位计算并返回角度值，该角度的正切值已由参数 val 指定。返回值介于负二分之 pi 和正二分之 pi 之间。

参数

val:Number — 表示角的正切值的一个数字。

Number — 介于负二分之 pi 和正二分之 pi 之间的一个数字。

atan2

()

方法

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

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

以弧度为单位计算并返回点 y/x 的角度，该角度从圆的 x 轴（0 点在其上，0 表示圆心）沿逆时针方向测量。返回值介于正 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 次幂的值，x 由参数 x 指定。常量 Math.E 可以提供 e 的值。

参数

val:Number — 指数；一个数字或表达式。

Number — e 的 x 次幂，x 由参数 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 大于等于 0，则为一个数字，否则为 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

2 的自然对数的数学常数，表示为 log_e2，其近似值为 0.6931471805599453。

LOG10E

常量

public static const LOG10E:Number = 0.4342944819032518

语言版本:

ActionScript 3.0

运行时版本:

AIR 1.0, Flash Player 9, Flash Lite 4

常数 e (Math.E) 以 10 为底的对数的数学常数，表示为 log₁₀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

语言元素

附录

类 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