flash player10 Vector类型-白红宇

flash player10 Vector类型

阅读量：4079 次

发布时间：2019-05-25

本文共 15825 字，大约阅读时间需要 52 分钟。

包
类	public dynamic class Vector
继承	Vector

语言版本:

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.
       
        ; v = new Vector.
        
         ();

在此示例的第一行内容中，变量 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.
       
         = new Vector.
        
         ();

要将基本类型为 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 添加值时，在编译时不会检查参数的数据类型，而会在运行时检查。

另请参见

公共属性

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

公共方法

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

属性详细信息

fixed

属性

fixed:

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

直接设置 length 属性

将值分配给索引位置 length

调用可更改 length 属性的方法，包括：
- pop()
- push()
- shift()
- unshift()
- splice()（如果 splice() 调用更改 Vector 的 length）。

实现

public function get fixed():

public function set fixed(value:):

length

属性

length:

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

实现

public function get length():

public function set length(value:):

引发

	— 如果在 `fixed` 为 `true` 时更改此属性。

	— 如果将此属性设置为一个大于允许的最大索引值 (2³²) 的值。

构造函数细节

Vector

()

构造函数

public function Vector(length: = 0, fixed: = false)

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

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

var v:Vector.
       
         = new Vector.
        
         ();

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

参数

	`length:` (default = `0`) — Vector 的初始长度（元素数目）。如果此参数大于零，则将创建指定数目的 Vector 元素，并使用适合基本类型的默认值（对于引用类型将使用 `null`）进行填充。

	`fixed:` (default = `false`) — Vector 的长度是固定的 (`true`) 还是可变的 (`false`)。可以使用 `fixed` 属性设置此值。

另请参见

方法详细信息

concat

()

方法

function concat( args):.<T>

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

hello world

参数

args — 将要在新的 Vector 中进行连接的此 Vector 的基本类型的一个或多个值。如果未传递任何值，则新 Vector 将是原始 Vector 的副本。

.<T> — 一个与此 Vector 具有相同的基本类型的 Vector，并且其中包含此 Vector 中的元素，后跟参数中的元素。

引发

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

every

()

方法

function every(callback:, thisObject: = null):

语言版本:

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.
       
        ):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.
       
        ):Boolean {    //your code here};myVector.every(myFunction, someObject);

参数

callback: — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数：Vector 中的当前项、当前项的索引和 Vector 对象：

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

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

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

— 在对 Vector 中的所有项调用指定函数时若返回 true，则为布尔值 true；否则为 false。

另请参见

filter

()

方法

function filter(callback:, thisObject: = null):.<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.
       
        ):Boolean {        // your code here     }

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

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

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

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

参数

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

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

.<T> — 一个新的 Vector，其中包含原始 Vector 中 callback 函数为其返回 true 的所有项目。

另请参见

forEach

()

方法

function forEach(callback:, thisObject: = null):

语言版本:

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.
       
        ):void {        // your code here     }

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

myVector.forEach(myFunction, someObject);

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

参数

callback: — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数：Vector 中的当前项、当前项的索引和 Vector 对象：

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

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

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

indexOf

()

方法

function indexOf(searchElement:T, fromIndex: = 0):

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

参数

	`searchElement:T` — 要在 Vector 中查找的项。

	`fromIndex:` (default = `0`) — 要在 Vector 中开始搜索指定项的位置。如果此参数为负数，则将其视为 `length + fromIndex`，这意味着搜索将从末尾倒数第 `-fromIndex` 项开始，并从该位置向前搜索直到 Vector 的末尾。

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

另请参见

join

()

方法

function join(sep: = ","):

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

参数

sep: (default = ",") — 在返回字符串中分隔 Vector 元素的字符或字符串。如果省略此参数，则使用逗号作为默认分隔符。

— 一个字符串，它由转换为字符串并以指定字符串分隔的 Vector 元素组成。

另请参见

lastIndexOf

()

方法

function lastIndexOf(searchElement:T, fromIndex: = 0x7fffffff):

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

参数

	`searchElement:T` — 要在 Vector 中查找的项。

	`fromIndex:` (default = `0x7fffffff`) — 要在 Vector 中开始搜索指定项的位置。默认值为允许的最大索引值，这表示搜索从 Vector 中的最后一项开始。如果此参数为负数，则将其视为 `length + fromIndex`，这意味着搜索将从末尾倒数第 `-fromIndex` 项开始，并且从该位置向后搜索直到索引 0。

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

另请参见

map

()

方法

function map(callback:, thisObject: = null):.<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 {        // 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.
       
        ):void {         //your code here     };     myVector.map(myFunction, someObject);

参数

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

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

.<T> — 一个新 Vector，其中包含对此 Vector 中的每一项调用函数所获得的结果。结果 Vector 具有与原始 Vector 相同的基本类型和 length。

另请参见

pop

()

方法

function pop():T

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

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

引发

— 如果在 fixed 为 true 时调用此方法。

另请参见

push

()

方法

function push( args):

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

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

参数

args — 要追加到 Vector 中的一个或多个值。

— 添加新元素后的 Vector 的长度。

引发

	— 如果任何参数都不是 Vector 的基本类型 `T` 的实例。

	— 如果在 `fixed` 为 `true` 时调用此方法。

另请参见

reverse

()

方法

function reverse():.<T>

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

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

shift

()

方法

function shift():T

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

T — Vector 中的第一个元素。

引发

— 如果 fixed 为 true。

另请参见

slice

()

方法

function slice(startIndex: = 0, endIndex: = 16777215):.<T>

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

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

参数

	`startIndex:` (default = `0`) — 一个数字，指定片段起始点的索引。如果 `startIndex` 是负数，则起始点从 Vector 的末尾开始，其中 -1 表示最后一个元素。

	`endIndex:` (default = `16777215`) — 一个数字，指定片段终点的索引。如果省略此参数，则片段包括从起始点到 Vector 的末尾的所有元素。如果 `endIndex` 是负数，则从 Vector 的末尾指定终点，其中 -1 表示最后一个元素。

.<T> — 一个 Vector，其中包含原始 Vector 中某一范围的元素。

some

()

方法

function some(callback:, thisObject: = null):

语言版本:

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.
       
        ):Boolean {        // your code here     }

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

myVector.some(myFunction, someObject);

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

参数

callback: — 要对 Vector 中的每一项运行的函数。调用此函数时需要使用以下三个参数：Vector 中的当前项、当前项的索引和 Vector 对象：

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

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

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

— 如果 Vector 中的所有项对于指定的函数都返回 true，则为布尔值 true；否则为 false。

另请参见

sort

()

方法

function sort(compareFunction:):.<T>

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

参数

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

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

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

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

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

0，如果 x 等于 y

一个正数，如果 x 应在排序后的序列中出现在 y 之后

.<T> — 其中的元素按新顺序进行排序的 Vector。

splice

()

方法

function splice(startIndex:, deleteCount:, items):.<T>

语言版本:

ActionScript 3.0

运行时版本:

Flash Player 10, AIR 1.5

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

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

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

参数

	`startIndex:` — 一个整数，它指定 Vector 中开始进行插入或删除的位置处的元素的索引。可以用一个负整数来指定相对于 Vector 的末尾的位置（例如，-1 表示 Vector 的最后一个元素）。

	`deleteCount:` — 一个整数，它指定要删除的元素数量。该数量包括 `startIndex` 参数中指定的元素。如果没有为 `deleteCount` 参数指定值，则该方法将删除从 `startIndex` 元素到 Vector 中最后一个元素的所有值。如果该参数的值为 0，则不删除任何元素。

	`items` — 以逗号分隔的一个或多个值的可选列表，此可选列表将插入 `startIndex` 参数中的指定位置处的 Vector。

.<T> — 一个 Vector，其中包含已从原始 Vector 中删除的元素。

引发

	— 如果 `startIndex` 和 `deleteCount` 参数指定要删除的索引超出了 Vector 的范围。

	— 如果在 `fixed` 为 `true` 且 `splice()` 操作更改 Vector 的 `length` 时调用此方法。