パッケージトップレベル
クラスpublic dynamic class Vector
継承Vector Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

Vector クラスを使用すると、ベクターにアクセスして操作することができます。ベクターとはすべてのエレメントが同じデータ型を持つ配列です。ベクターのエレメントのデータ型は、ベクターのベース型と呼ばれています。 ベース型は、ビルトインクラスとカスタムクラスを含む任意のクラスです。ベース型は、Vector 変数の宣言時とクラスコンストラクタの呼び出しによるインスタンスの作成時に指定されます。

配列の場合と同様に、配列アクセス([])演算子を使用すると、ベクターエレメントの値を設定または取得できます。 また、いくつかのベクターのメソッドは、エレメントの値を設定および取得するためのメカニズムを備えています。 これらののメソッドには、push()pop()shift()unshift() などがあります。 Vector オブジェクトのプロパティとメソッドは、配列のプロパティとメソッドと似ており、ほとんどの場合は同じです。すべてのエレメントが同じデータ型を持つ配列を使用する場合は、Vector インスタンスが推奨されます。

ベクターのベース型は、後置型パラメータシンタックスを使用して指定されます。型パラメータシンタックスは、ドット(.)、左山括弧(<)、クラス名、右山括弧(>)で構成されます。

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

この例の最初の行では、変数 v が Vector.<String> インスタンスとして宣言されます。 つまり、この行は String インスタンスのみ保持することができ、String インスタンスのみ取得できるベクター(配列)を表します。2 番目の行は、同じ Vector 型(つまり、エレメントがすべて String オブジェクトであるベクター)のインスタンスを構築し、v に割り当てます。

Vector.<T> データ型によって宣言された変数は、同じベース型 T を使用して構築された Vector インスタンスのみ格納することができます。 例えば、新しい Vector.<String>() を呼び出すことによって構築されたベクターは、Vector.<int> データ型によって宣言された変数に割り当てることはできません。ベース型は完全に一致する必要があります。例えば、次のコードは、オブジェクトのベース型が宣言された変数のベース型と同じでないため(Sprite が DisplayObject のサブクラスであっても)コンパイルされません。

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

ベース型 T を持つベクターを T のスーパークラスのベクターに変換するには、Vector() グローバル関数を使用します。

データ型の制限に加えて、Vector クラスには Array クラスと区別される次のようなその他の制限があります。

このような制限の結果として、ベクターでは、エレメントがすべて単一クラスのインスタンスとなる Array インスタンスにはない、次の 2 つの主要な利点が得られます。

関連項目

[] 配列アクセス
Vector() グローバル関数
Array クラス
Creating a Vector instance


パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
  fixed : Boolean
ベクターの length プロパティを変更できるかどうかを指定します。
Vector
  length : uint
ベクター内で使用できる有効なインデックスの範囲です。
Vector
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
  
Vector(length:uint = 0, fixed:Boolean = false)
指定されたベース型を持つベクターを作成します。
Vector
  
concat(... args):Vector.<T>
パラメータで指定されたエレメントをベクター内のエレメントと連結して、新しいベクターを作成します。
Vector
  
every(callback:Function, thisObject:Object = null):Boolean
指定された関数について false を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。
Vector
  
filter(callback:Function, thisObject:Object = null):Vector.<T>
ベクター内の各アイテムについてテスト関数を実行し、指定された関数について true を返すすべてのアイテムを含む新しいベクターを返します。
Vector
  
forEach(callback:Function, thisObject:Object = null):void
ベクター内の各アイテムについて関数を実行します。
Vector
 Inherited
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
  
indexOf(searchElement:T, fromIndex:int = 0):int
ベクター内のアイテムを検索し、アイテムのインデックス位置を返します。
Vector
 Inherited
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
join(sep:String = ","):String
ベクター内のエレメントをストリングに変換し、指定されたセパレータをエレメント間に挿入し、エレメントを連結して、その結果をストリングとして返します。
Vector
  
lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int
ベクター内のアイテムを、指定されたインデックス位置から後方に向かって検索し、一致したアイテムのインデックス位置を返します。
Vector
  
map(callback:Function, thisObject:Object = null):Vector.<T>
ベクター内の各アイテムについて関数を実行し、このベクター内の各アイテムに対する関数の呼び出しの結果に対応するアイテムの新しいベクターを返します。
Vector
  
pop():T
ベクターの最後のエレメントを削除して、そのエレメントを返します。
Vector
 Inherited
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
  
push(... args):uint
エレメントをベクターの最後に追加して、ベクターの新しい長さを返します。
Vector
  
ベクター内のエレメントの順序を反転します。
Vector
 Inherited
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
  
shift():T
ベクターの最初のエレメントを削除して、そのエレメントを返します。
Vector
  
slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>
元のベクターから一連のエレメントを取り出して、新しいベクターを返します。元のベクターは変更されません。
Vector
  
some(callback:Function, thisObject:Object = null):Boolean
true を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。
Vector
  
sort(compareFunction:Function):Vector.<T>
ベクター内のエレメントをソートします。
Vector
  
splice(startIndex:int, deleteCount:uint, ... items):Vector.<T>
ベクターのエレメントを追加および削除します。
Vector
  
指定されたベクター内のエレメントを表すストリングを返します。
Vector
  
ベクター内のエレメントを表すストリングを返します。
Vector
  
エレメントをベクターの先頭に追加して、ベクターの新しい長さを返します。
Vector
 Inherited
指定されたオブジェクトのプリミティブな値を返します。
Object
プロパティの詳細
fixedプロパティ
fixed:Boolean  [読み書き可能]

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクターの length プロパティを変更できるかどうかを指定します。値が false の場合、length プロパティは変更できません。 これは、fixedtrue の場合、次の操作は行うことができないことを意味します。



実装
    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 インスタンスは、length 値(ただし、最大値は除く)までのインデックス位置を持ちます。

ずべてのベクターエレメントは、常にベース型のインスタンスまたは null のいずれかの値を持ちます。 length プロパティが前の値より大きい値に設定されている場合、追加のエレメントが作成され、ベース型に適したデフォルト値(参照型の場合は null)が設定されます。

length プロパティが前の値より小さい値に設定されている場合、新しい 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.<T>() コンストラクタを呼び出すときに、型パラメータシンタックスを使用してベース型を指定します。型パラメータシンタックスは、ドット(.)、左山括弧(<)、クラス名、右山括弧(>)で構成されます。

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

Array クラスと異なり、Vector.<T>() コンストラクタを使用して事前設定された Vector インスタンスを作成することはできません。配列または他のベクター(異なるベース型を持つベクターなど)から Vector インスタンスを作成するには、Vector() グローバル関数を使用します。

パラメータ
length:uint (default = 0) — ベクターの初期長さ(エレメント数)です。このパラメータが 0 より大きい場合、指定された数のベクターエレメントが作成され、ベース型に適したデフォルト値が設定されます(参照型の場合、null)。
 
fixed:Boolean (default = false) — ベクターの長さが固定されるか(true)、または変更できるか(false)を指定します。 この値は fixed プロパティを使用して設定することもできます。

関連項目

メソッドの詳細
concat()メソッド
AS3 function concat(... args):Vector.<T>

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

パラメータで指定されたエレメントをベクター内のエレメントと連結して、新しいベクターを作成します。パラメータでベクターを指定すると、そのベクターのエレメントが連結されます。

hello world

パラメータ

... args — 新しいベクターに連結されるこのベクターのベース型の 1 つ以上の値。値を渡さない場合、新しいベクターは元のベクターの複製になります。

戻り値
Vector.<T> — このベクターの後にパラメータのエレメントが続くベクターと同じベース型を持つベクター。

例外
TypeError — 引数がベース型のインスタンスではない場合で、ベース型に変換できない場合。
every()メソッド 
AS3 function every(callback:Function, thisObject:Object = null):Boolean

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

指定された関数について false を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。 このメソッドを使用して、ベクター内のすべてのアイテムがある基準(値が特定の数値より小さいなど)を満たしているかどうかを判別できます。

このメソッドで、2 番目のパラメータ thisObject は、null でなければなりません(最初のパラメータ callback がメソッド閉包である場合)。 これは、このメソッドの最も一般的な使用方法です。

ただし、メインタイムライン上のフレームで関数を作成するが、異なる this コンテキストで呼び出す必要があるとします。

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

次に、every() メソッドを、myVector というベクターに対して使用するとします。

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 オブジェクトの 3 つの引数によって呼び出されます。
function callback(item:T, index:int, vector:Vector.<T>):Boolean {
    // your code here
 }

コールバック関数はブール値を返します。

 
thisObject:Object (default = null) — 関数が呼び出されるときにコールバック関数の識別子 this が参照するオブジェクトです。

戻り値
Boolean — ブール値です。指定された関数について、ベクター内のいずれかのアイテムが true を返す場合は true を返します。それ以外の場合は false を返します。

関連項目

filter()メソッド 
AS3 function filter(callback:Function, thisObject:Object = null):Vector.<T>

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内の各アイテムについてテスト関数を実行し、指定された関数について true を返すすべてのアイテムを含む新しいベクターを返します。false を返すアイテムは、結果ベクターに含められません。 戻りベクターのベース型はメソッドが呼び出されるベクターのベース型と一致します。

このメソッドで、2 番目のパラメータ thisObject は、null でなければなりません(最初のパラメータ callback がメソッド閉包である場合)。 これは、このメソッドの最も一般的な使用方法です。

ただし、メインタイムライン上のフレームで関数を作成するが、異なる this コンテキストで呼び出す必要があるとします。

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

次に、filter() メソッドを、myVector というベクターに対して使用するとします。

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 オブジェクトの 3 つの引数によって呼び出されます。
function callback(item:T, index:int, vector:Vector.<T>):Boolean;
 
thisObject:Object (default = null) — 関数が呼び出されるときにコールバック関数の識別子 this が参照するオブジェクトです。

戻り値
Vector.<T> — 元のベクター内のアイテムで callback 関数が true を返したものをすべて含む新しいベクター。

関連項目

forEach()メソッド 
AS3 function forEach(callback:Function, thisObject:Object = null):void

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内の各アイテムについて関数を実行します。

このメソッドで、2 番目のパラメータ thisObject は、null でなければなりません(最初のパラメータ callback がメソッド閉包である場合)。 これは、このメソッドの最も一般的な使用方法です。

ただし、メインタイムライン上のフレームで関数を作成するが、異なる this コンテキストで呼び出す必要があるとします。

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

次に、forEach() メソッドを、myVector というベクターに対して使用するとします。

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 オブジェクトの 3 つの引数によって呼び出されます。
function callback(item:T, index:int, vector:Vector.<T>):void;

関数呼び出しの戻り値は破棄されます。

 
thisObject:Object (default = null) — 関数が呼び出されるときにコールバック関数の識別子 this が参照するオブジェクトです。

indexOf()メソッド 
AS3 function indexOf(searchElement:T, fromIndex:int = 0):int

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内のアイテムを検索し、アイテムのインデックス位置を返します。 アイテムは、厳密な等価(===)を使用してベクターエレメントと比較されます。

パラメータ

searchElement:T — ベクター内で検索するアイテムです。
 
fromIndex:int (default = 0) — アイテムの検索を開始するベクター内の場所です。このパラメータが負の場合、length + fromIndex として扱われます。つまり、検索は最後の -fromIndex アイテムから開始し、その位置から前方に向かってベクターの最後まで検索します。

戻り値
int — ベクター内のアイテムの 0 から始まるインデックス位置です。searchElement 引数が見つからなかった場合、戻り値は -1 です。

関連項目

join()メソッド 
AS3 function join(sep:String = ","):String

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内のエレメントをストリングに変換し、指定されたセパレータをエレメント間に挿入し、エレメントを連結して、その結果をストリングとして返します。ネストされたベクターは、join() メソッドに渡されるセパレータで区切るのではなく、常にカンマ(,)で区切ります。

パラメータ

sep:String (default = ",") — 返されたストリング内のベクターエレメントを区切る文字またはストリングです。このパラメータを省略すると、デフォルトのセパレータとしてカンマが使用されます。

戻り値
String — ストリングに変換されたベクターのエレメントで構成され、指定されたストリングで区切られているストリングです。

関連項目

lastIndexOf()メソッド 
AS3 function lastIndexOf(searchElement:T, fromIndex:int = 0x7fffffff):int

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内のアイテムを、指定されたインデックス位置から後方に向かって検索し、一致したアイテムのインデックス位置を返します。 アイテムは、厳密な等価(===)を使用してベクターエレメントと比較されます。

パラメータ

searchElement:T — ベクター内で検索するアイテムです。
 
fromIndex:int (default = 0x7fffffff) — アイテムの検索を開始するベクター内の場所です。デフォルトは、許容される最大インデックス値です。つまり、検索はベクター内の最後のアイテムから開始されます。

このパラメータが負の場合、length + fromIndex として扱われます。つまり、検索は最後の -fromIndex アイテムから開始し、その位置から後方に向かってインデックス 0 まで検索します。

戻り値
int — ベクター内のアイテムの 0 から始まるインデックス位置です。searchElement 引数が見つからなかった場合、戻り値は -1 です。

関連項目

map()メソッド 
AS3 function map(callback:Function, thisObject:Object = null):Vector.<T>

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内の各アイテムについて関数を実行し、このベクター内の各アイテムに対する関数の呼び出しの結果に対応するアイテムの新しいベクターを返します。結果ベクターには、元のベクターと同じベース型と length が指定されます。結果ベクターのインデックス i のエレメントは、元のベクターのインデックス i のエレメントでの呼び出しの結果です。

このメソッドで、2 番目のパラメータ thisObject は、null でなければなりません(最初のパラメータ callback がメソッド閉包である場合)。 これは、このメソッドの最も一般的な使用方法です。

ただし、メインタイムライン上のフレームで関数を作成するが、異なる this コンテキストで呼び出す必要があるとします。

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

次に、map() メソッドを、myVector というベクターに対して使用するとします。

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 オブジェクトの 3 つの引数によって呼び出されます。
function callback(item:T, index:int, vector:Vector.<T>):T;
 
thisObject:Object (default = null) — 関数が呼び出されるときにコールバック関数の識別子 this が参照するオブジェクトです。

戻り値
Vector.<T> — ベクター内の各アイテムに対する関数の呼び出しの結果が含まれる新しいベクターです。結果ベクターには、元のベクターと同じベース型と length が指定されます。

関連項目

pop()メソッド 
AS3 function pop():T

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクターの最後のエレメントを削除して、そのエレメントを返します。この関数が呼び出されるときに、ベクターの length プロパティは 1 つ減少します。

戻り値
T — 指定されたベクターの最後のエレメントの値です。

例外
RangeError fixedtrue のときにこのメソッドが呼び出された場合。

関連項目

push()メソッド 
AS3 function push(... args):uint

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

エレメントをベクターの最後に追加して、ベクターの新しい長さを返します。

この関数は複数の引数を受け入れることができるので、Strict モードの場合でも、コンパイル時に引数のデータ型はチェックされません。ただし、ベース型のインスタンスではない引数が渡されると、実行時に例外が発生します。

パラメータ

... args — ベクターに追加される値です。

戻り値
uint — 新しいエレメントが追加された後のベクターの長さです。

例外
TypeError — 引数がベクターのベース型 T のインスタンスではない場合。
 
RangeError fixedtrue のときにこのメソッドが呼び出された場合。

関連項目

reverse()メソッド 
AS3 function reverse():Vector.<T>

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内のエレメントの順序を反転します。このメソッドは呼び出されるベクターを変更します。

戻り値
Vector.<T> — 逆の順序のエレメントを持つベクター。
shift()メソッド 
AS3 function shift():T

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクターの最初のエレメントを削除して、そのエレメントを返します。残りのベクターエレメントは、元の位置 i から i - 1 に移動されます。

戻り値
T — ベクター内の最初のエレメント。

例外
RangeError fixedtrue の場合。

関連項目

slice()メソッド 
AS3 function slice(startIndex:int = 0, endIndex:int = 16777215):Vector.<T>

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

元のベクターから一連のエレメントを取り出して、新しいベクターを返します。元のベクターは変更されません。返されるベクターには、startIndex エレメントから endIndex の前のエレメントまでのすべてのエレメントが含まれます。

パラメータを何も渡さないと、元のベクターの複製が作成されます。

パラメータ

startIndex:int (default = 0) — スライスの始点のインデックスを示す数値です。 startIndex が負の数値の場合、始点はベクターの末尾から開始します。つまり、-1 が最後のエレメントです。
 
endIndex:int (default = 16777215) — スライスの終点のインデックスを示す数値です。 このパラメータを省略すると、スライスにはベクターの最初から最後までのすべてのエレメントが取り込まれます。endIndex が負の数値の場合、終点はベクターの末尾から開始します。つまり、-1 が最後のエレメントです。

戻り値
Vector.<T> — 元のベクターから取り出した一連のエレメントから成るベクターです。
some()メソッド 
AS3 function some(callback:Function, thisObject:Object = null):Boolean

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

true を返すアイテムに達するまで、ベクター内の各アイテムにテスト関数を実行します。 このメソッドを使用して、ベクター内のいずれのアイテムもある基準(値が特定の数値より小さいなど)を満たしているかどうかを判別できます。

このメソッドで、2 番目のパラメータ thisObject は、null でなければなりません(最初のパラメータ callback がメソッド閉包である場合)。 これは、このメソッドの最も一般的な使用方法です。

ただし、メインタイムライン上のフレームで関数を作成するが、異なる this コンテキストで呼び出す必要があるとします。

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

次に、some() メソッドを、myVector というベクターに対して使用するとします。

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 オブジェクトの 3 つの引数によって呼び出されます。
function callback(item:T, index:int, vector:Vector.<T>):Boolean

コールバック関数はブール値を返します。

 
thisObject:Object (default = null) — 関数が呼び出されるときにコールバック関数の識別子 this が参照するオブジェクトです。

戻り値
Boolean — ブール値です。指定された関数についてベクター内のいずれかのアイテムが true を返す場合は true を返します。それ以外の場合は false を返します。

関連項目

sort()メソッド 
AS3 function sort(compareFunction:Function):Vector.<T>

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内のエレメントをソートします。このメソッドは、compareFunction パラメータとして提供される関数に基づいてソートを実行します。

パラメータ

compareFunction:Function — ソートの動作を設定する比較メソッドです。

指定したメソッドはベクターのベース型(T)の 2 つの引数を受け取り、数値を返す必要があります。

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

compareFunction 関数のロジックにより、2 つのエレメント xy が指定された場合、この関数は次の 3 つの値のいずれかを返します。

  • xy の前に表示されるソート順の場合は負の数。
  • xy が等しい場合は 0。
  • xy の後に表示されるソート順の場合は正の数。

戻り値
Vector.<T> — 新しい順序のエレメントを持つベクター。
splice()メソッド 
AS3 function splice(startIndex:int, deleteCount:uint, ... items):Vector.<T>

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクターのエレメントを追加および削除します。このメソッドは、コピーを作成しないで、ベクターを変更します。

注意:ベクターのサブクラス内でこのメソッドをオーバーライドするには、次の例に示すように、パラメータに ...args を使用します。

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

パラメータ

startIndex:int — 挿入または削除を開始するベクターエレメントのインデックスを示す整数です。負の整数を使用すると、ベクターの末尾を基準として位置を指定できます。例えば、-1 はベクターの最後のエレメントです。
 
deleteCount:uint — 削除するエレメント数を示す整数です。この数には、startIndex パラメータで指定するエレメントが含まれます。deleteCount パラメータに値を指定しないと、ベクター内の startIndex の位置のエレメントから最後のエレメントまで、すべての値が削除されます。値として 0 を指定すると、エレメントは削除されません。
 
... itemsstartIndex パラメータで指定したベクター内の位置に挿入するカンマ区切り値またはベクターのオプションリストです。

戻り値
Vector.<T> — 元のベクターから削除されたエレメントを含むベクターです。

例外
RangeError startIndexdeleteCount 引数がベクターの境界外にあるインデックスを削除するように指定する場合。
 
RangeError — このメソッドが fixedtrue のときに呼び出され、splice() 演算によってベクターの length が変更された場合。
toLocaleString()メソッド 
public function toLocaleString():String

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

指定されたベクター内のエレメントを表すストリングを返します。インデックス 0 から最大インデックスまでのベクター内のすべてのエレメントを、カンマで区切られた連結ストリングに変換して返します。ActionScript 3.0 実装において、このメソッドは、Vector.toString() と同じ値を返します。

戻り値
String — ベクターエレメントのストリングです。

関連項目

toString()メソッド 
public function toString():String

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

ベクター内のエレメントを表すストリングを返します。インデックス 0 から最大インデックスまでのベクター内のすべてのエレメントを、カンマで区切られた連結ストリングに変換して返します。カスタムセパレータを指定するには、Vector.join() メソッドを使用します。

戻り値
String — ベクターエレメントのストリングです。

関連項目

unshift()メソッド 
AS3 function unshift(... args):uint

言語バージョン: ActionScript 3.0
ランタイムバージョン: Flash Player 10, AIR 1.5

エレメントをベクターの先頭に追加して、ベクターの新しい長さを返します。ベクター内のその他のエレメントは、元の位置 i から i に新しいエレメントの数を加えた位置に移動されます。

この関数は複数の引数を受け入れることができるので、Strict モードの場合でも、コンパイル時に引数のデータ型はチェックされません。ただし、ベース型のインスタンスではない引数が渡されると、実行時に例外が発生します。

パラメータ

... args — ベクターの先頭に挿入されるこのベクターのベース型の 1 つ以上のインスタンス。

戻り値
uint — ベクターの新しい長さを表す整数です。

例外
TypeError — 引数がベクターのベース型 T のインスタンスではない場合。
 
RangeError fixedtrue のときにこのメソッドが呼び出された場合。

関連項目