Actionscript3.0 自带函数集(顶级函数)
顶级或全局函数在使用 ActionScript 的 SWF 文件的任何部分或任何用户定义的类中都可用。已将 ActionScript 2.0 中的大部分全局函数迁移到类中。 语言版本 : ActionScript 3.0 Player 版本 : Flash Player 9 全局 函数 函数 定义方 Array(... args):Array
创建一个新数组。
Boolean(expression:Object):Boolean
将 expression 参数转换为布尔值并返回该值。
Date():String
返回当前星期值、日期值、时间和时区的字符串表示形式。 decodeURI(uri:String):String
将已编码的 URI 解码为字符串。
decodeURIComponent(uri:String):String
将已编码的 URI 组件解码为字符串。 encodeURI(uri:String):String
将字符串编码为有效的 URI(统一资源标识符)。 encodeURIComponent(uri:String):String
将字符串编码为有效的 URI 组件。
Top Level Top Level Top Level Top Level Top Level Top Level Top Level
escape(str:String):String
将参数转换为字符串,并以 URL 编码格式对其进行编码,在这种格式中,大多数非Top Level
字母数字的字符都替换为 % 十六进制序列。 int(value:Number):int
将给定数字值转换成整数值。
Top Level
isFinite(num:Number):Boolean Top Level
如果该值为有限数,则返回 true,如果该值为正无穷大或负无穷大,则返回 false。 isNaN(num:Number):Boolean
如果该值为 NaN(非数字),则返回 true。
isXMLName(str:String):Boolean
确定指定字符串对于 XML 元素或属性是否为有效名称。 Number(expression:Object):Number
将给定值转换成数字值。
Top Level Top Level Top Level
Object(value:Object):Object 在 ActionScript 3.0 中,每个值都是一个对象,这意味着对某个值调用 Object() 会Top Level
返回该值。 parseFloat(str:String):Number
将字符串转换为浮点数。
parseInt(str:String, radix:uint = 0):Number
将字符串转换为整数。 String(expression:Object):String
返回指定参数的字符串表示形式。
Top Level Top Level Top Level
trace(... arguments):void
调试时显示表达式或写入日志文件。 uint(value:Number):uint
将给定数字值转换成无符号整数值。
Top Level Top Level
unescape(str:String):String
将参数 str 作为字符串计算,从 URL 编码格式解码该字符串(将所有十六进制序列Top Level
转换成 ASCII 字符),并返回该字符串。 XML(expression:Object):XML
将对象转换成 XML 对象。
XMLList(expression:Object):XMLList
将某对象转换成 XMLList 对象。
Top Level Top Level
顶级常量或全局常量在每个脚本中都可用,并且对文档中的所有时间轴和作用域都可见。 全局 常量 常量 定义方 Infinity : Number
表示正无穷大的特殊值。 -Infinity : Number
表示负无穷大的特殊值。
NaN : Number
Number 数据类型的一个特殊成员,用来表示“非数字”(NaN) 值。
Top Level Top Level Top Level
undefined : * Top Level
一个适用于尚未初始化的无类型变量或未初始化的动态对象属性的特殊值。 常量详细信息 Infinity常量
public const Infinity:Number
表示正 Infinity 的特殊值。 此常数的值与 Number.POSITIVE_INFINITY 相同。 另请参见 Number.POSITIVE_INFINITY 示例
除以 0 的结果为 Infinity(仅当除数为正数时)。 trace(0 / 0); // NaN
trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity
-Infinituy常量
public const -Infinity:Number
表示负 Infinity 的特殊值。 此常数的值与 Number.NEGATIVE_INFINITY 相同。 另请参见 Number.NEGATIVE_INFINITY 示例
除以 0 的结果为 -Infinity(仅当除数为负数时)。 trace(0 / 0); // NaN
trace(7 / 0); // Infinity trace(-7 / 0); // -Infinity NaN常量
public const NaN:Number
Number 数据类型的一个特殊成员,用来表示“非数字”(NaN) 值。 当数学表达式生成的值无法表示为数字时,结果为 NaN。 下表描述了生成 NaN 的常用表达式。
? 除以 0 可生成 NaN(仅当除数也为 0 时)。 如果除数大于 0,除以 0 的结果为 Infinity。
如果除数小于 0,除以 0 的结果为 -Infinity; ? 负数的平方根;
? 在有效范围 0 到 1 之外的数字的反正弦值; ? Infinity 减去 Infinity;
? Infinity 或 -Infinity 除以 Infinity 或 -Infinity; ? Infinity 或 -Infinity 乘以 0; NaN 值不是 int 或 uint 数据类型的成员。 NaN 值不被视为等于任何其它值(包括 NaN),因而无法使用等于运算符测试一个表达式是否为 NaN。 若要确定一个数字是否为 NaN 函数,请使用 isNaN()。 另请参见 isNaN() Number.NaN undefined常量
public const undefined:*
一个适用于尚未初始化的无类型变量或未初始化的动态对象属性的特殊值。 在 ActionScript 3.0 中,只有无类型变量才能采用值 undefined,这在 ActionScript 1.0 和 ActionScript 2.0 中并非如此。例如,以下两个变量都是 undefined,因为它们都未类型化或初始化:
? var foo; ? var bar:*;
undefined 值还适用于动态对象的未初始化或未定义的属性。 例如,如果某对象是 Object 类的一个实例,则除非向该属性赋予值,否则动态添加的任何属性的值将为 undefined。 将 undefined 用于不同的函数时,结果也不相同:
? 由 String(undefined) 返回的值为 \(undefined 转换为字符串)。 ? 由 Number(undefined) 返回的值为 NaN。
? 由 int(undefined) 和 uint(undefined) 返回的值为 0。 ? 由 Object(undefined) 返回的值为新的 Object 实例。
? 向类型变量赋予值 undefined 时,该值将转换为该数据类型的默认值。
不要混淆 undefined 和 null。 使用等于运算符 (==) 对 null 和 undefined 进行比较时,它们的比较结果为相等。 但是,使用全等运算符 (===) 对 null 和 undefined 进行比较时,它们的比较结果为不相等。 另请参见 null 示例
在以下示例中,将声明(但不初始化)一个无类型变量 myVar。 myVar 的值为 undefined,因为该变量是一个无类型变量。 无论变量是没有类型注释,还是使用特殊的 (*) 无类型注释 (var myVar:*;),都是如此。
/* trace value of untyped and uninitialized variable */ var myVar;
trace(myVar); // undefined
该规则同样适用于动态对象的未初始化属性。 例如,给定实例 obj(属于动态类 A),obj.propName(obj 实例的未初始化属性)的值为 undefined。 dynamic class A {} var obj:A = new A()
// trace undefined property of obj trace(obj.propName); // undefined 函数详细信息 Array()函数
public function Array(... args):Array
创建一个新数组。 可以是长度为 0 或大于 0 的数组,也可以是由一组指定元素(可能具有不同的数据类型)填充的数组。 所使用参数的数目和数据类型决定了返回数组的内容。
? 在不使用参数的情况下调用 Array() 会返回空的数组。
? 使用单个整数参数调用 Array() 可返回具有指定长度的数组,但数组元素具有未定义的值。 ? 使用一组指定值调用 Array() 将返回由包含各个指定值的元素构成的数组。 使用 Array() 函数类似于使用 Array 类构造函数创建数组。
当参数不是原始值时,应使用 as 运算符进行显式类型转换或类型转换。 有关详细信息,请参阅本条目的“示例”部分。 参数
... args — 不传递参数可以创建空数组,传递单个整数参数可以创建具有特定长度的数组,传
递一系列由逗号分隔的具有各种类型的值可创建使用这些值填充的数组。 返回
Array — 长度为 0 或大于 0 的数组。 另请参见 Array class as operator 示例
下面的示例演示 Array() 函数在参数不是原始值时的行为。 转换为数组的一种常见用法是转换以数组格式存储值的 Object 实例。 如果调用 Array() 时使用了 Object 类型或其它任何非原始数据类型的参数,则对对象的引用将存储在新数组的元素中。 也就是说,如果传递的唯一参数是一个对象,则对该对象的引用将成为新数组的第一个元素。 var obj:Object = [ \var newArray:Array = Array( obj ); trace(newArray == obj); // false trace(newArray[0] == obj); // true trace(newArray[0][0]); // a trace(newArray[0][1]); // b trace(newArray[0][2]); // c
若要将 obj 转换为数组,请使用 as 运算符,它将在 obj 为有效数组的情况下返回数组引用,否则返回 null:
var obj:Object = [ \var newArray:Array = obj as Array; trace(newArray == obj); // true trace(newArray[0]); // a trace(newArray[1]); // b trace(newArray[2]); // c Boolean()函数
public function Boolean(expression:Object):Boolean 将 expression 参数转换为布尔值并返回该值。 返回值取决于参数的数据类型和值,如下表所述:
输入值
0 NaN 空字符串 非空字符串 null undefined Object 类的实例
示例
Boolean(0) Boolean(NaN) Boolean(\Boolean(\Boolean(null) Boolean(undefined)
返回值 false false true false true false false
数字(非 0 或 NaN) Boolean(4)
Boolean(new Object()) true
无参数 Boolean() false
与 ActionScript 的早期版本不同,Boolean() 函数与 Boolean 类构造函数返回相同的结果。 参数
expression:Object — 要转换为 Boolean 的表达式或对象。 返回
Boolean — 转换为 Boolean 的结果。 另请参见 数据类型说明 类型转换 Date()函数
public function Date():String
返回当前星期值、日期值、时间和时区的字符串表示形式。 输出的日期格式为: Day Mon Date HH:MM:SS TZD YYYY 例如:
Wed Apr 12 15:30:17 GMT-0700 2006
若要将某个值转换为 Date 类型,请使用 x as Date 代替 Date(x)。 返回 String — 作为 String 数据类型的当前日期。 Date() 的返回值与 Date.toString() 的返回值
相同。
另请参见 Date class as operator decodeURI()函数
public function decodeURI(uri:String):String
将已编码的 URI 解码为字符串。 返回一个字符串,其中以前由 encodeURI 函数编码的所有字符都还原为它们的未编码表示形式。
下表显示不会 由 decodeURI 函数解码为字符的转义序列的集合。 使用 decodeURIComponent() 可解码此表中的转义序列。 未解码的转义序列 字符等效形式 # $ & + , / : ; = ?
# $ & + , / : ; = ?
@ @ 参数
uri:String — 一个使用 encodeURI 函数编码的字符串。 返回 String — 一个字符串,其中以前由 encodeURI 函数转义的所有字符都还原为它们的未转义表示
形式。
另请参见 decodeURIComponent() encodeURI() encodeURIComponent() 示例
package {
import flash.display.Sprite;
百度搜索“77cn”或“免费范文网”即可找到本站免费阅读全部范文。收藏本站方便下次阅读,免费范文网,提供经典小说综合文库Actionscript3.0自带函数集(顶级函数)在线全文阅读。
相关推荐: