顶级 

表示负 Infinity 的特殊值。此常量的值与 Number.NEGATIVE_INFINITY 相同。

相关 API 元素

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

表示正 Infinity 的特殊值。此常量的值与 Number.POSITIVE_INFINITY 相同。

相关 API 元素

trace(0 / 0);  // NaN
trace(7 / 0);  // Infinity
trace(-7 / 0); // -Infinity

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()。

相关 API 元素

一个适用于尚未初始化的无类型变量或未初始化的动态对象属性的特殊值。在 ActionScript 3.0 中，只有无类型变量才能采用值 undefined，这在 ActionScript 1.0 和 ActionScript 2.0 中并非如此。例如，以下两个变量都是 undefined，因为它们都未类型化或初始化：

• var foo;
• var bar:*;

undefined 值还适用于动态对象的未初始化或未定义的属性。例如，如果某对象是 Object 类的一个实例，则除非向该属性赋予值，否则动态添加的任何属性的值将为 undefined。

将 undefined 用于不同的函数时，结果也不相同：

• 由 String(undefined) 返回的值为 "undefined"（undefined 转换为字符串）。
• 由 Number(undefined) 返回的值为 NaN。
• 由 int(undefined) 和 uint(undefined) 返回的值为 0。
• 由 Object(undefined) 返回的值为新的 Object 实例。
• 向类型变量赋予值 undefined 时，该值将转换为该数据类型的默认值。

不要混淆 undefined 和 null。使用等于运算符 (==) 对 null 和 undefined 进行比较时，它们的比较结果为相等。但是，使用 strict equality (===) 运算符对 null 和 undefined 进行比较时，它们的比较结果为不相等。

相关 API 元素

// trace value of untyped and uninitialized variable
var myVar;
trace(myVar); // undefined

dynamic class A {}
var obj:A = new A()

// trace undefined property of obj
trace(obj.propName); // undefined

创建一个新数组。数组可以是零长度或更大长度，或者是由一个指定的对象填充的数组。

• 在不使用参数的情况下调用 Array() 会返回空的数组。
• 使用单个整数参数调用 Array() 可返回具有指定长度的数组，但数组元素具有未定义的值。
• 调用具有指定对象的 Array() 将返回一个具有该指定对象的元素的数组。

注意：如果您尝试使用 Array() 函数创建一个新数组，并将多个值作为参数传递以填充该数组，将出现编译器错误。Array() 函数只允许一个参数。相反，应使用 Array 类构造函数创建和填充一个多值数组。

Array() 函数不将对象的类型转换为数组。当参数不是原始值时，应使用 as 运算符进行显式类型转换或类型转换。有关详细信息，请参阅本条目的“示例”部分。如果您将对象作为参数传递给 Array() 函数，会创建一个新数组，其中包含此对象作为元素。

参数

相关 API 元素

var obj:Object = [ "a", "b", "c" ];
      
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

var obj:Object = [ "a", "b", "c" ];
      
var newArray:Array = obj as Array;

trace(newArray == obj); // true
trace(newArray[0]);     // a
trace(newArray[1]);     // b
trace(newArray[2]);     // c

将 expression 参数转换为布尔值并返回该值。

返回值取决于参数的数据类型和值，如下表所述：

与 ActionScript 的早期版本不同，Boolean() 函数与 Boolean 类构造函数返回相同的结果。

参数

将已编码的 URI 解码为字符串。返回一个字符串，其中以前由 encodeURI 函数编码的所有字符都还原为它们的未编码表示形式。

下表显示不会 由 decodeURI 函数解码为字符的转义序列的集合。使用 decodeURIComponent() 可解码此表中的转义序列。

参数

相关 API 元素

package {
    import flash.display.Sprite;

    public class DecodeURIExample extends Sprite {
        public function DecodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

将已编码的 URI 组件解码为字符串。返回一个字符串，其中以前由 encodeURIComponent 函数转义的所有字符都还原为它们的未编码表示形式。

此函数与 decodeURI() 函数不同，它仅适用于 URI 字符串的一部分（称为 URI 组件）。URI 组件是指出现在某些特殊字符之间的任何文本，这些特殊字符称为组件分隔符（: / ; 和 ?）。“http”和“www.adobe.com”是常见的 URI 组件示例。

此函数与 decodeURI() 的另一个重要区别是：由于此函数假定它处理的是 URI 组件，因此它会将表示特殊分隔符字符 (; / ? : @ & = + $ , #) 的转义序列视为应进行解码的常规文本。

参数

相关 API 元素

将字符串编码为有效的 URI（统一资源标识符）。将完整的 URI 转换为一个字符串，其中除属于一小组基本字符的字符外，其他所有字符都以 UTF-8 转义序列进行编码。

下表显示不会 由 encodeURI 函数转换为 UTF-8 转义序列的基本字符的整个集合。

参数

相关 API 元素

package {
    import flash.display.Sprite;

    public class EncodeURIExample extends Sprite {
        public function EncodeURIExample() {
            var uri:String = "http://www.example.com/application.jsp?user=<user name='some user'></user>";
            var encoded:String = encodeURI(uri);
            var decoded:String = decodeURI(encoded);
            trace(uri);        // http://www.example.com/application.jsp?user=<user name='some user'></user>
            trace(encoded);    // http://www.example.com/application.jsp?user=%3Cuser%20name='some%20user'%3E%3C/user%3E
            trace(decoded);    // http://www.example.com/application.jsp?user=<user name='some user'></user>
        }
    }
}

将字符串编码为有效的 URI 组件。将 URI 的子字符串转换为一个字符串，其中除属于非常小的一组基本字符的字符外，其他所有字符都以 UTF-8 转义序列进行编码。

encodeURIComponent() 函数与 encodeURI() 函数不同，它仅适用于 URI 字符串的一部分（称为 URI 组件）。URI 组件是指出现在某些特殊字符之间的任何文本，这些特殊字符称为组件分隔符（: / ; 和 ?）。“http”和“www.adobe.com”是常见的 URI 组件示例。

此函数与 encodeURI() 的另一个重要区别是：由于此函数假定它处理的是 URI 组件，因此它会将特殊分隔符字符 (; / ? : @ & = + $ , #) 视为应进行编码的常规文本。

下表显示不会 由 encodeURIComponent 函数转换为 UTF-8 转义序列的所有字符。

参数

相关 API 元素

将参数转换为字符串，并以 URL 编码格式对其进行编码，在这种格式中，大多数非字母数字的字符都替换为 % 十六进制序列。当用于 URL 编码的字符串时，百分号 (%) 用于引入转义字符，不与模运算符 (%) 等效。

下表显示不会 由 escape() 函数转换为转义序列的所有字符。

注意：请使用 encodeURIComponent() 函数（而不是 escape() 函数）将特殊分隔符 (@ + /) 做为常规文本进行编码。

参数

相关 API 元素

将给定数字值转换成整数值。从小数点处截断十进制值。

参数

相关 API 元素

如果该值为有限数，则返回 true，如果该值为 Infinity 或 -Infinity，则返回 false。出现的 Infinity 或 -Infinity 表示存在错误的数学条件，例如除以 0。

参数

如果该值为 NaN（非数字），则返回 true。isNaN() 函数可用于检查一个数学表达式是否成功地计算为一个数字。isNaN() 最常用于检查从 parseInt() 和 parseFloat() 函数返回的值。NaN 值是 Number 数据类型的特殊成员，用来表示“非数字”值。

注意：NaN 值不是 int 或 uint 数据类型的成员。

下表描述 isNaN() 针对各种输入类型和值的返回值。（如果编译器警告设置为“严谨模式”，则下面的某些操作将生成编译器警告。）

参数

确定指定字符串对于 XML 元素或属性是否为有效名称。

参数

将给定值转换成数字值。下表显示各种输入类型的结果：

参数

在 ActionScript 3.0 中，每个值都是一个对象，这意味着对某个值调用 Object() 会返回该值。

参数

将字符串转换为浮点数。此函数读取或分析 并返回字符串中的数字，直到此函数遇到不是初始数字一部分的字符。如果字符串不是以可以分析的数字开头，parseFloat() 将返回 NaN。有效整数前面的空白将被忽略，有效整数后面的非数字字符也将被忽略。

参数

将字符串转换为整数。如果参数中指定的字符串不能转换为数字，则此函数返回 NaN。以 0x 开头的字符串被解释为十六进制数字。与 ActionScript 的早期版本不同，以 0 开头的整数不会被解释为八进制数字。必须指定 8 的基数才能解释为八进制数字。有效整数前面的空白和 0 以及后面的非数字字符将被忽略。

参数

返回指定参数的字符串表示形式。

下表显示各种输入类型的结果：

参数

调试时显示表达式或写入日志文件。单个跟踪语句可支持多个参数。如果跟踪语句中的任何参数包含 String 之外的数据类型，则跟踪函数将调用与该数据类型关联的 toString() 方法。例如，如果该参数是一个布尔值，则跟踪函数将调用 Boolean.toString() 并显示返回值。

参数

package {
    import flash.display.Sprite;

    public class TraceExample extends Sprite {

        public function TraceExample() {
            trace("Hello World");
        }
    }
}

将给定数字值转换成无符号整数值。从小数点处截断十进制值。

下表描述 uint() 针对各种输入类型和值的返回值。

参数

相关 API 元素

将参数 str 作为字符串计算，从 URL 编码格式解码该字符串（将所有十六进制序列转换成 ASCII 字符），并返回该字符串。

参数

创建新的 Vector 实例，其元素为指定数据类型的实例。在调用此函数时，可使用类型参数指定结果 Vector 元素的数据类型（Vector 的基本类型）。此函数使用的语法与声明 Vector 实例或调用 new Vector.<T>() 构造函数时所使用的语法相同：

var v:Vector.<String> = Vector.<String>(["Hello", "World"]);

用 sourceArray 参数的元素中的值填充结果 Vector。如果 sourceArray 参数已经是 Vector.<T> 实例（其中 T 为基本类型），则函数将返回该 Vector。否则，将用 sourceArray Array 或 Vector 的元素填充结果 Vector。

在上述任一情况下，sourceArray 参数的所有元素的数据类型都必须与函数调用中指定的基本类型 T 匹配。

如果 sourceArray 参数的 length 为 0，则此函数将返回一个空白 Vector。

如果 Vector 作为 sourceArray 参数传递且其基本类型不是 T，或者如果传递一个 Array 且其元素并不全是数据类型 T 的实例，则会尝试将值转换为基本类型。如果这些值可以自动转换，则结果 Vector 中会包含转换后的值。如果无法进行任何转换，则会出现一个错误。

同样，如果 sourceArray 参数中的某个元素是基本类型 T 的子类的实例，则调用成功，并且该元素将添加到结果 Vector 中。即使 sourceArray 参数是一个 Vector 并且其基本类型是 T 的子类，也会出现上述情况。实际上，只有通过这种方法才能将基本类型为 T 的 Vector 转换为基本类型为 T 的子类的 Vector。

例如，由于以下代码尝试将 Vector.<Sprite> 分配给 Vector，因此该代码在严谨模式下会导致出现编译错误或在运行时导致出现 TypeError。<DisplayObject> 变量（Sprite 是 DisplayObject 的子类）：

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = v1;
     

以下替代版本的代码可成功地将 Vector.<Sprite> 实例的元素复制到 Vector.<DisplayObject> 实例中：

     var v1:Vector.<Sprite> = new Vector.<Sprite>();
     v1[0] = new Sprite();
     var v2:Vector.<DisplayObject> = Vector.<DisplayObject>(v1);
     

参数

相关 API 元素

将对象转换成 XML 对象。

下表介绍各种输入类型的返回值。

参数

相关 API 元素

将某对象转换成 XMLList 对象。

下表介绍各种输入类型的返回值。

参数

相关 API 元素