Vector  - AS3

表示能否更改 Vector 的 length 属性。如果值是 true，则无法更改 length 属性。这表示当 fixed 为 true 时，不允许执行以下操作：

• 直接设置 length 属性
• 将值分配给索引位置 length
• 调用可更改 length 属性的方法，包括：
  • pop()
  • push()
  • shift()
  • unshift()
  • splice()（如果 splice() 调用更改 Vector 的 length）。

Vector 中可用的有效索引的范围。Vector 实例具有最大不超过 length 值的索引位置（但不包括此值）。

每个 Vector 元素始终具有一个值，该值要么为一个基本类型的实例，要么为 null。若将 length 属性设置为一个大于其先前值的值时，则将创建额外的元素，并使用适合基本类型的默认值（对于引用类型使用 null）来填充这些元素。

当 length 属性设置为一个小于其先前值的值时，将从 Vector 中删除位于大于或等于新 length 值的索引位置处的所有元素。

使用指定的基本类型创建 Vector。

当调用 Vector.<T>() 构造函数时，将使用类型参数语法指定基本类型。类型参数语法是一个序列，其中依次包含点 (.)、左尖括号 (<)、类名称和右尖括号 (>)，如下例所示：

     var v:Vector.<String> = new Vector.<String>();
     

要从一个 Array 或另一个 Vector（例如具有不同的基本类型的 Vector）创建 Vector 实例，请使用 Vector() 全局函数。

要创建预填充的 Vector 实例，请使用以下语法而不是下面指定的参数：

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

下面的信息适用于此语法：

• Flash Professional CS5 和更高版本、Flash Builder 4 和更高版本以及 Flex 4 和更高版本中支持此语法。
• 尾部的逗号是可选的。
• 不支持数组中含空项；var v:Vector.<int> = new <int>[0,,2,] 这样的语句会引发编译器错误。
• 无法为 Vector 实例指定默认长度。该长度与初始化列表中元素的数目相同。
• 无法指定 Vector 实例是否具有定长。而是使用 fixed 属性。
• 如果作为值传递的项与指定类型不相匹配，则可能会发生数据丢失或错误。例如：

     var v:Vector.<int> = new <int>[4.2]; // compiler error when running in strict mode
     trace(v[0]); //returns 4 when not running in strict mode
     

相关 API 元素

将参数列表中指定的矢量与此矢量中的元素进行连接并创建新的矢量。参数列表中的矢量必须与此矢量具有相同的基本类型或子类型。如果不传递任何参数，则返回的矢量是原始矢量的副本（浅表克隆）。

参数

对 Vector 中的每一项执行测试函数，直到获得对指定的函数返回 false 的项。使用此方法可确定 Vector 中的所有项是否满足某一条件，如具有小于某一特定数字的值。

在此方法中，如果第一个参数 callback 为 closure 方法，则第二个参数 thisObject 必须为 null。这是使用此方法的最常见方式。

但是，假设您使用 Flash Professional 在主时间轴上的某个帧上创建函数，但希望在其他 this 上下文中调用此函数：

    function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

假设对名为 myVector 的 Vector 使用 every() 方法：

    myVector.every(myFunction, someObject);
    

由于 myFunction 是 SWF 文件的主类的成员，因此无法在其他 this 上下文中执行。此代码运行时，Flash 运行时会引发异常。通过将该函数分配给某个变量（如下所示），可以避免这种运行时错误：

    var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
        //your code here
    };
    myVector.every(myFunction, someObject);
    

参数

function callback(item:T, index:int, vector:Vector.<T>):Boolean {
       // your code here
    }
    

相关 API 元素

对 Vector 中的每一项执行测试函数，并返回一个新 Vector，其中包含的所有项都对指定的函数返回 true。如果某项返回 false，则结果 Vector 中将不包含此项。返回的 Vector 的基本类型与对其调用此方法的 Vector 的基本类型匹配。

在此方法中，如果第一个参数 callback 为 closure 方法，则第二个参数 thisObject 必须为 null。这是使用此方法的最常见方式。

但是，假设您使用 Flash Professional 在主时间轴上的某个帧上创建函数，但希望在其他 this 上下文中调用此函数：

     function myFunction(item:T, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

假设对名为 myVector 的 Vector 使用 filter() 方法：

     var result:Vector.<T> = myVector.filter(myFunction, someObject);
     

由于 myFunction 是 SWF 文件的主类的成员，因此无法在其他 this 上下文中执行。此代码运行时，Flash 运行时会引发异常。通过将该函数分配给某个变量（如下所示），可以避免这种运行时错误：

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.filter(myFunction, someObject);
     

参数

function callback(item:T, index:int, vector:Vector.<T>):Boolean;

相关 API 元素

对 Vector 中的每一项执行某个函数。

在此方法中，如果第一个参数 callback 为 closure 方法，则第二个参数 thisObject 必须为 null。这是使用此方法的最常见方式。

但是，假设您使用 Flash Professional 在主时间轴上的某个帧上创建函数，但希望在其他 this 上下文中调用此函数：

     function myFunction(item:T, index:int, vector:Vector.<T>):void {
        // your code here
     }
     

假设对名为 myVector 的 Vector 使用 forEach() 方法：

     myVector.forEach(myFunction, someObject);
     

由于 myFunction 是 SWF 文件的主类的成员，因此无法在其他 this 上下文中执行。此代码运行时，Flash 运行时会引发异常。通过将该函数分配给某个变量（如下所示），可以避免这种运行时错误：

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.forEach(myFunction, someObject);
     

参数

function callback(item:T, index:int, vector:Vector.<T>):void;

搜索 Vector 中的某个项，并返回该项的索引位置。使用全等运算符 (===) 将此项与 Vector 元素进行比较。

参数

相关 API 元素

向 Vector 中插入一个单独的元素。此方法会修改 Vector 但不制作副本。

参数

将 Vector 中的元素转换为字符串，在元素间插入指定的分隔符，连接这些元素，然后返回结果字符串。嵌套 Vector 总是以逗号 (,) 分隔，而不使用传递给 join() 方法的分隔符分隔。

参数

相关 API 元素

在 Vector 中搜索一个项（从指定的索引位置向后搜索），并返回匹配项的索引位置。使用全等运算符 (===) 将此项与 Vector 元素进行比较。

参数

相关 API 元素

对 Vector 中的每一项执行函数并返回一个新 Vector，其中包含与此 Vector 中的每一项的函数调用结果相对应的项。结果 Vector 具有与原始 Vector 相同的基本类型和 length。位于结果 Vector 中的索引 i 位置的元素是对位于原始 Vector 中的索引 i 位置的元素进行调用所获得的结果。

在此方法中，如果第一个参数 callback 为 closure 方法，则第二个参数 thisObject 必须为 null。这是使用此方法的最常见方式。

但是，假设您使用 Flash Professional 在主时间轴上的某个帧上创建函数，但希望在其他 this 上下文中调用此函数：

     function myFunction(item:Object, index:int, vector:Vector.<T>):T {
        // your code here
     }
     

假设对名为 myVector 的 Vector 使用 map() 方法：

     myVector.map(myFunction, someObject);
     

由于 myFunction 是 SWF 文件的主类的成员，因此无法在其他 this 上下文中执行。此代码运行时，Flash 运行时会引发异常。通过将该函数分配给某个变量（如下所示），可以避免这种运行时错误：

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):void {
         //your code here
     };
     myVector.map(myFunction, someObject);
     

参数

function callback(item:T, index:int, vector:Vector.<T>):T;

相关 API 元素

删除 Vector 中的最后一个元素，并返回该元素。当调用此函数时，将 Vector 的 length 属性值减一。

相关 API 元素

将一个或多个元素添加到 Vector 的结尾，并返回该 Vector 的新长度。

由于此函数可接受多个参数，因此在编译时不会检查参数的数据类型（即使在严谨模式下也不检查）。但是，如果传递的参数不是基本类型的实例，则在运行时会出现异常。

参数

相关 API 元素

从 Vector 中删除一个单独的元素。此方法会修改 Vector 但不制作副本。

参数

颠倒 Vector 中元素的顺序。此方法会改变对其进行调用的 Vector。

删除 Vector 中的第一个元素，并返回该元素。其余的 Vector 元素将从其原始位置 i 移至 i - 1。

相关 API 元素

返回由原始 Vector 中某一范围的元素构成的新 Vector，而不修改原始 Vector。返回的 Vector 包括从 startIndex 元素开始到 endIndex 元素（但不包括该元素）的所有元素。

如果不传递任何参数，则新 Vector 是原始 Vector 的副本（浅表克隆）。如果为两个参数都传递值 0，则将创建新的与原始 Vector 相同类型的空 Vector。

参数

对 Vector 中的每一项执行测试函数，直到获得返回 true 的项。使用此方法可确定 Vector 中的所有项是否满足条件，如具有小于某一特定数字的值。

在此方法中，如果第一个参数 callback 为 closure 方法，则第二个参数 thisObject 必须为 null。这是使用此方法的最常见方式。

假设在主时间轴的帧上创建一个函数，并希望在不同的 this 上下文中调用此函数：

     function myFunction(item:Object, index:int, vector:Vector.<T>):Boolean {
        // your code here
     }
     

假设对名为 myVector 的 Vector 使用 some() 方法：

     myVector.some(myFunction, someObject);
     

由于 myFunction 是 SWF 文件的主类的成员，因此无法在其他 this 上下文中执行。此代码运行时，Flash 运行时会引发异常。通过将该函数分配给某个变量（如下所示），可以避免这种运行时错误：

     var myFunction:Function = function(item:T, index:int, vector:Vector.<T>):Boolean {
         //your code here
     };
     myVector.some(myFunction, someObject);
     

参数

function callback(item:T, index:int, vector:Vector.<T>):Boolean

相关 API 元素

对 Vector 对象中的元素进行排序，并且还会返回排序后的 Vector 对象。此方法根据参数 sortBehavior 进行排序，该参数是一个比较两个值的函数，或一组排序选项。

该方法具有一个参数。此参数为以下值之一：

• 一个函数，具有两个 Vector 的基本类型 (T) 的参数，并返回一个数字：

  function compare(x:T, y:T):Number {}

  函数的逻辑为：给定两个元素 x 和 y，此函数返回以下三个值之一：

  • 一个负数，如果 x 应在排序后的序列中出现在 y 之前
  • 0，如果 x 等于 y
  • 一个正数，如果 x 应在排序后的序列中出现在 y 之后

• 一个数字，为以下值的按位 OR：
  • 1 或 Array.CASEINSENSITIVE
  • 2 或 Array.DESCENDING
  • 4 或 Array.UNIQUESORT
  • 8 或 Array.RETURNINDEXEDARRAY
  • 16 或 Array.NUMERIC

  如果值为 0，则按以下方式进行排序：

  • 排序区分大小写（Z 优先于 a）。
  • 按升序排序（a 优先于 b）。
  • 修改该数组以反映排序顺序；在排序后的数组中不按任何特定顺序连续放置具有相同排序字段的多个元素。
  • 元素无论属于何种数据类型，都作为字符串进行排序，所以 100 在 99 之前，这是因为 "1" 的字符串值小于 "9" 的字符串值。

参数

相关 API 元素

对 Vector 添加元素以及从 Vector 中删除元素。此方法会修改 Vector 但不制作副本。

注意：要在 Vector 的子类中覆盖此方法，请使用 ...args 作为参数，如下例所示：

     public override function splice(...args) {
       // your statements here
     }
     

参数

返回一个字符串，它表示指定 Vector 中的元素。Vector 中的每一个元素（从索引 0 开始到最大索引结束）均会转换为一个连接字符串，并以逗号分隔。在 ActionScript 3.0 实现中，此方法与 Vector.toString() 方法返回相同的值。

相关 API 元素

返回一个字符串，它表示 Vector 中的元素。Vector 中的每一个元素（从索引 0 开始到最大索引结束）均会转换为一个连接字符串，并以逗号分隔。要指定自定义的分隔符，请使用 Vector.join() 方法。

相关 API 元素

将一个或多个元素添加到 Vector 的开头，并返回该 Vector 的新长度。Vector 中的其它元素从其原始位置 i 移到 i + 新元素的数目。

由于此函数可接受多个参数，因此在编译时不会检查参数的数据类型（即使在严谨模式下也不检查）。但是，如果传递的参数不是基本类型的实例，则在运行时会出现异常。

参数

相关 API 元素