• flash player10 Vector类型


    顶级
    public dynamic class Vector
    继承 Vector Inheritance Object
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

        使用 Vector 类可以访问和操作矢量(即所有元素均具有相同数据类型的数组)。Vector 的元素数据类型称作 Vector 的基本类型。基本类型可以是任何类,包括内置类和自定义类。在声明 Vector 变量以及通过调用类构造函数创建实例时,将指定基本类型。

    与 Array 类似,可以使用数组访问 ([]) 运算符设置或检索 Vector 元素的值。一些 Vector 方法还提供了用于设置和检索元素值的机制。其中包括 push()pop()shift()unshift(),等等。Vector 对象的属性和方法与 Array 的属性和方法类似(大多数情况下完全相同)。对于任何需要使用所有元素都具有相同数据类型的 Array 的情况,Vector 实例更为可取。

    可使用后缀类型参数语法指定 Vector 的基本类型。类型参数语法是一个序列,其中依次包含点 (.)、左尖括号 (<)、类名称和右尖括号 (>),如下例所示:

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

    在此示例的第一行内容中,变量 v 声明为 Vector.<String> 实例。换句话说,它表示一个只能容纳 String 实例的 Vector(数组),并且从中只能检索 String 实例。第二行代码构造了同一 Vector 类型的实例(即,一个所有元素均为 String 对象的 Vector),并将该实例分配给 v

    使用 Vector.<T> 数据类型声明的变量只能存储用相同的基本类型 T 构造的 Vector 实例。例如,不能将通过调用 new Vector.<String>() 构造的 Vector 分配给使用 Vector.<int> 数据类型声明的变量。基本类型必须完全匹配。例如,不会对下列代码进行编译,原因是对象的基本类型与变量声明的基本类型不同(即使 Sprite 是 DisplayObject 的子类):

     // This code doesn't compile even though Sprite is a DisplayObject subclass var v:Vector.<DisplayObject> = new Vector.<Sprite>(); 

    要将基本类型为 T 的 Vector 转换为超类 T 的 Vector,请使用 Vector() 全局函数。

    除数据类型限制之外,Vector 类还具有其他一些限制,从而有别于 Array 类:

    • Vector 是一种密集数组。与 Array 不同,Vector 必须在每个索引中包含一个值(或 null),而前者可以只在索引 0 和 7 中包含值(即使位置 1 到 6 中不存在任何值)。
    • Vector 可以具有固定长度,这意味着其所包含的元素数量不可更改。
    • 对 Vector 的元素的访问需要接受范围检查。绝对不能从大于最后一个元素 (length - 1) 的索引中读取值。绝对不能对超过当前最后一个索引一个以上的索引设置值(也就是说,只能在现有索引或索引 [length] 中设置值)。

    由于 Vector 具有这些限制,因此 Vector 相对于所有元素均为单个类的实例的 Array 实例有两个主要优点:

    • 性能:使用 Vector 实例时的数组元素访问和迭代的速度比使用 Array 时的速度要快很多。
    • 类型安全性:在严格模式下,编译器可以识别数据类型错误,例如,将数据类型错误的值分配给 Vector 或从 Vector 中读取值时使用错误的数据类型。但请注意,当使用 push() 方法或 unshift() 方法向 Vector 添加值时,在编译时不会检查参数的数据类型,而会在运行时检查。

    另请参见



    公共属性
     属性定义方
      Inherited constructor : Object
    对类对象或给定对象实例的构造函数的引用。
    Object
        fixed : Boolean
    指示能否更改 Vector 的 length 属性。
    Vector
        length : uint
    Vector 中可用的有效索引的范围。
    Vector
      Inherited prototype : Object
    [静态] 对类或函数对象的原型对象的引用。
    Object

    公共方法
     方法定义方
       
    Vector(length:uint = 0, fixed:Boolean = false)
    使用指定的基本类型创建 Vector。
    Vector
       
    concat(... args):Vector.<T>
    将参数中指定的元素与 Vector 中的元素进行连接并创建新的 Vector。
    Vector
       
    every(callback:Function, thisObject:Object = null):Boolean
    对 Vector 中的每一项执行测试函数,直到获得对指定的函数返回 false 的项。
    Vector
       
    filter(callback:Function, thisObject:Object = null):Vector.<T>
    对 Vector 中的每一项执行测试函数,并返回一个新 Vector,其中包含的所有项都对指定的函数返回 true。
    Vector
       
    forEach(callback:Function, thisObject:Object = null):void
    对 Vector 中的每一项执行某个函数。
    Vector
      Inherited
    指示对象是否已经定义了指定的属性。
    Object
       
    indexOf(searchElement:T, fromIndex:int = 0):int
    搜索 Vector 中的某个项,并返回该项的索引位置。
    Vector
      Inherited
    指示 Object 类的实例是否在指定为参数的对象的原型链中。
    Object
       
    join(sep:String = ","):String
    将 Vector 中的元素转换为字符串,在元素间插入指定的分隔符,连接这些元素,然后返回结果字符串。
    Vector
       
    lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int
    在 Vector 中搜索一个项(从指定的索引位置向后搜索),并返回匹配项的索引位置。
    Vector
       
    map(callback:Function, thisObject:Object = null):Vector.<T>
    对 Vector 中的每一项执行函数并返回一个新 Vector,其中包含与此 Vector 中的每一项的函数调用结果相对应的项。
    Vector
       
    pop():T
    删除 Vector 中的最后一个元素,并返回该元素。
    Vector
      Inherited
    指示指定的属性是否存在、是否可枚举。
    Object
       
    push(... args):uint
    将一个或多个元素添加到 Vector 的结尾,并返回该 Vector 的新长度。
    Vector
       
    颠倒 Vector 中元素的顺序。
    Vector
      Inherited
    设置循环操作动态属性的可用性。
    Object
       
    shift():T
    删除 Vector 中的第一个元素,并返回该元素。
    Vector
       
    slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>
    返回由原始 Vector 中某一范围的元素构成的新 Vector,而不修改原始 Vector。
    Vector
       
    some(callback:Function, thisObject:Object = null):Boolean
    对 Vector 中的每一项执行测试函数,直到获得返回 true 的项。
    Vector
       
    sort(compareFunction:Function):Vector.<T>
    对 Vector 中的元素进行排序。
    Vector
       
    splice(startIndex:int, deleteCount:uint, ... items):Vector.<T>
    对 Vector 添加元素以及从 Vector 中删除元素。
    Vector
       
    返回一个字符串,它表示指定 Vector 中的元素。
    Vector
       
    返回一个字符串,它表示 Vector 中的元素。
    Vector
       
    将一个或多个元素添加到 Vector 的开头,并返回该 Vector 的新长度。
    Vector
      Inherited
    返回指定对象的原始值。
    Object
    属性详细信息

    fixed

    属性
    fixed:Boolean
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    指示能否更改 Vector 的 length 属性。如果值为 false,则无法更改 length 属性。这表示当 fixedtrue 时,不允许执行以下操作:

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


    实现
        public function get fixed():Boolean
        public function set fixed(value:Boolean):void

    length

    属性  
    length:uint
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

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

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



    实现
        public function get length():uint
        public function set length(value:uint):void

    引发
    RangeError — 如果在 fixedtrue 时更改此属性。
     
    RangeError — 如果将此属性设置为一个大于允许的最大索引值 (232) 的值。
    构造函数细节

    Vector

    () 构造函数
    public function Vector(length:uint = 0, fixed:Boolean = false)
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

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

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

    与 Array 类不同,不能使用 Vector.<T>() 构造函数来创建预填充的 Vector 实例。要从一个 Array 或另一个 Vector(例如具有不同的基本类型的 Vector)创建 Vector 实例,请使用 Vector() 全局函数。

    参数
    length:uint (default = 0) — Vector 的初始长度(元素数目)。如果此参数大于零,则将创建指定数目的 Vector 元素,并使用适合基本类型的默认值(对于引用类型将使用 null)进行填充。
     
    fixed:Boolean (default = false) — Vector 的长度是固定的 (true) 还是可变的 (false)。可以使用 fixed 属性设置此值。

    另请参见

    方法详细信息

    concat

    () 方法
    AS3 function concat(... args):Vector.<T>
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    将参数中指定的元素与 Vector 中的元素进行连接并创建新的 Vector。如果这些参数指定一个 Vector,则将连接该 Vector 中的元素。

    hello world

    参数

    ... args — 将要在新的 Vector 中进行连接的此 Vector 的基本类型的一个或多个值。如果未传递任何值,则新 Vector 将是原始 Vector 的副本。
    返回
    Vector.<T> — 一个与此 Vector 具有相同的基本类型的 Vector,并且其中包含此 Vector 中的元素,后跟参数中的元素。

    引发
    TypeError — 如果任何参数都不是基本类型的实例且不能转换为基本类型。

    every

    () 方法  
    AS3 function every(callback:Function, thisObject:Object = null):Boolean
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    对 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 Player 或 AIR 会引发异常。通过将该函数分配给某个变量(如下所示),可以避免这种运行时错误:

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

    参数

    callback:Function — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数:Vector 中的当前项、当前项的索引和 Vector 对象:
    function callback(item:T, index:int, vector:Vector.<T>):Boolean {   // your code here}

    callback 函数应返回一个布尔值。

     
    thisObject:Object (default = null) — 调用 callback 函数时该函数中的标识符 this 引用的对象。
    返回
    Boolean — 在对 Vector 中的所有项调用指定函数时若返回 true,则为布尔值 true;否则为 false

    另请参见

    filter

    () 方法  
    AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    对 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 Player 会引发异常。通过将该函数分配给某个变量(如下所示),可以避免这种运行时错误:

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

    参数

    callback:Function — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数:Vector 中的当前项、当前项的索引和 Vector 对象:
    function callback(item:T, index:int, vector:Vector.<T>):Boolean;
     
    thisObject:Object (default = null) — 调用 callback 函数时该函数中的标识符 this 引用的对象。
    返回
    Vector.<T> — 一个新的 Vector,其中包含原始 Vector 中 callback 函数为其返回 true 的所有项目。

    另请参见

    forEach

    () 方法  
    AS3 function forEach(callback:Function, thisObject:Object = null):void
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    对 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 Player 会引发异常。通过将该函数分配给某个变量(如下所示),可以避免这种运行时错误:

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

    参数

    callback:Function — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数:Vector 中的当前项、当前项的索引和 Vector 对象:
    function callback(item:T, index:int, vector:Vector.<T>):void;

    通过此函数调用获得的任何返回值都将被丢弃。

     
    thisObject:Object (default = null) — 调用 callback 函数时该函数中的标识符 this 引用的对象。

    indexOf

    () 方法  
    AS3 function indexOf(searchElement:T, fromIndex:int = 0):int
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    参数

    searchElement:T — 要在 Vector 中查找的项。
     
    fromIndex:int (default = 0) — 要在 Vector 中开始搜索指定项的位置。如果此参数为负数,则将其视为 length + fromIndex,这意味着搜索将从末尾倒数第 -fromIndex 项开始,并从该位置向前搜索直到 Vector 的末尾。
    返回
    int — Vector 中的项的从零开始的索引位置。如果未找到 searchElement 参数,则返回值为 -1。

    另请参见

    join

    () 方法  
    AS3 function join(sep:String = ","):String
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    参数

    sep:String (default = ",") — 在返回字符串中分隔 Vector 元素的字符或字符串。如果省略此参数,则使用逗号作为默认分隔符。
    返回
    String — 一个字符串,它由转换为字符串并以指定字符串分隔的 Vector 元素组成。

    另请参见

    lastIndexOf

    () 方法  
    AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    参数

    searchElement:T — 要在 Vector 中查找的项。
     
    fromIndex:int (default = 0x7fffffff) — 要在 Vector 中开始搜索指定项的位置。默认值为允许的最大索引值,这表示搜索从 Vector 中的最后一项开始。

    如果此参数为负数,则将其视为 length + fromIndex,这意味着搜索将从末尾倒数第 -fromIndex 项开始,并且从该位置向后搜索直到索引 0。

    返回
    int — Vector 中的项的从零开始的索引位置。如果未找到 searchElement 参数,则返回值为 -1。

    另请参见

    map

    () 方法  
    AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    对 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 Player 会引发异常。通过将该函数分配给某个变量(如下所示),可以避免这种运行时错误:

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

    参数

    callback:Function — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数:Vector 中的当前项、当前项的索引和 Vector 对象:
    function callback(item:T, index:int, vector:Vector.<T>):T;
     
    thisObject:Object (default = null) — 调用 callback 函数时该函数中的标识符 this 引用的对象。
    返回
    Vector.<T> — 一个新 Vector,其中包含对此 Vector 中的每一项调用函数所获得的结果。结果 Vector 具有与原始 Vector 相同的基本类型和 length

    另请参见

    pop

    () 方法  
    AS3 function pop():T
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    返回
    T — 指定的 Vector 中最后一个元素的值。

    引发
    RangeError — 如果在 fixedtrue 时调用此方法。

    另请参见

    push

    () 方法  
    AS3 function push(... args):uint
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

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

    参数

    ... args — 要追加到 Vector 中的一个或多个值。
    返回
    uint — 添加新元素后的 Vector 的长度。

    引发
    TypeError — 如果任何参数都不是 Vector 的基本类型 T 的实例。
     
    RangeError — 如果在 fixedtrue 时调用此方法。

    另请参见

    reverse

    () 方法  
    AS3 function reverse():Vector.<T>
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    返回
    Vector.<T> — 元素顺序颠倒的 Vector。

    shift

    () 方法  
    AS3 function shift():T
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    返回
    T — Vector 中的第一个元素。

    引发
    RangeError — 如果 fixedtrue

    另请参见

    slice

    () 方法  
    AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    如果您没有传递任何参数,则创建原始 Vector 的一个副本。

    参数

    startIndex:int (default = 0) — 一个数字,指定片段起始点的索引。如果 startIndex 是负数,则起始点从 Vector 的末尾开始,其中 -1 表示最后一个元素。
     
    endIndex:int (default = 16777215) — 一个数字,指定片段终点的索引。如果省略此参数,则片段包括从起始点到 Vector 的末尾的所有元素。如果 endIndex 是负数,则从 Vector 的末尾指定终点,其中 -1 表示最后一个元素。
    返回
    Vector.<T> — 一个 Vector,其中包含原始 Vector 中某一范围的元素。

    some

    () 方法  
    AS3 function some(callback:Function, thisObject:Object = null):Boolean
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    对 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 Player 会引发异常。通过将该函数分配给某个变量(如下所示),可以避免这种运行时错误:

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

    参数

    callback:Function — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数:Vector 中的当前项、当前项的索引和 Vector 对象:
    function callback(item:T, index:int, vector:Vector.<T>):Boolean

    callback 函数应返回一个布尔值。

     
    thisObject:Object (default = null) — 调用 callback 函数时该函数中的标识符 this 引用的对象。
    返回
    Boolean — 如果 Vector 中的所有项对于指定的函数都返回 true,则为布尔值 true;否则为 false

    另请参见

    sort

    () 方法  
    AS3 function sort(compareFunction:Function):Vector.<T>
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

    对 Vector 中的元素进行排序。此方法根据作为 compareFunction 参数提供的函数执行排序。

    参数

    compareFunction:Function — 一种可确定排序行为的比较方法。

    指定的方法必须采用两个 Vector 基本类型 (T) 的参数并返回一个 Number:

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

    compareFunction 函数的逻辑为:给定两个元素 xy,此函数将返回以下三个值之一:

    • 一个负数,如果 x 应在排序后的序列中出现在 y 之前
    • 0,如果 x 等于 y
    • 一个正数,如果 x 应在排序后的序列中出现在 y 之后
    返回
    Vector.<T> — 其中的元素按新顺序进行排序的 Vector。

    splice

    () 方法  
    AS3 function splice(startIndex:int, deleteCount:uint, ... items):Vector.<T>
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

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

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

    参数

    startIndex:int — 一个整数,它指定 Vector 中开始进行插入或删除的位置处的元素的索引。可以用一个负整数来指定相对于 Vector 的末尾的位置(例如,-1 表示 Vector 的最后一个元素)。
     
    deleteCount:uint — 一个整数,它指定要删除的元素数量。该数量包括 startIndex 参数中指定的元素。如果没有为 deleteCount 参数指定值,则该方法将删除从 startIndex 元素到 Vector 中最后一个元素的所有值。如果该参数的值为 0,则不删除任何元素。
     
    ... items — 以逗号分隔的一个或多个值的可选列表,此可选列表将插入 startIndex 参数中的指定位置处的 Vector。
    返回
    Vector.<T> — 一个 Vector,其中包含已从原始 Vector 中删除的元素。

    引发
    RangeError — 如果 startIndexdeleteCount 参数指定要删除的索引超出了 Vector 的范围。
     
    RangeError — 如果在 fixedtruesplice() 操作更改 Vector 的 length 时调用此方法。

    toLocaleString

    () 方法  
    public function toLocaleString():String
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    返回
    String — 由 Vector 元素组成的字符串。

    另请参见

    toString

    () 方法  
    public function toString():String
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

    返回
    String — 由 Vector 元素组成的字符串。

    另请参见

    unshift

    () 方法  
    AS3 function unshift(... args):uint
    语言版本:  ActionScript 3.0
    运行时版本:  Flash Player 10, AIR 1.5

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

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

    参数

    ... args — 要在 Vector 的开头插入的 Vector 的基本类型的一个或多个实例。
    返回
    uint — 一个整数,表示 Vector 的新长度。

    引发
    TypeError — 如果任何参数都不是 Vector 的基本类型 T 的实例。
     
    RangeError — 如果在 fixedtrue 时调用此方法。

    另请参见

  • 相关阅读:
    CentOS中的中文乱码问题的解决
    xml2config not found. Please check your libxml2 installation.
    yii数据库存储对象DAO
    linux常用svn命令
    通过rpm包安装、配置及卸载mysql的详细过程.
    php Undefined index和Undefined variable的解决方法
    【30篇突击 android】源码统计四
    【30篇突击 android】源码统计三
    Android 新手入门指导
    android 问题汇总系列之三
  • 原文地址:https://www.cnblogs.com/jiahuafu/p/1770482.html
Copyright © 2020-2023  润新知