Vector  - AS3

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

• length プロパティの直接的な設定
• インデックス位置 length への値の割り当て
• length プロパティを変更する以下のメソッドの呼び出し
  • pop()
  • push()
  • Shift()
  • unshift()
  • splice()（splice() 呼び出しがベクターの length を変更する場合）

ベクター内で使用できる有効なインデックスの範囲です。Vector インスタンスは、length 値（ただし、最大値は除く）までのインデックス位置を持ちます。

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

length プロパティが前の値より小さい値に設定されている場合、新しい length 値以上のインデックス位置にあるすべてのエレメントがベクターから削除されます。

指定されたベース型を持つベクターを作成します。

Vector.<T>() コンストラクターを呼び出すときに、型パラメーターシンタックスを使用してベース型を指定します。型パラメーターシンタックスは、ドット（.）、左山括弧（<）、クラス名、右山括弧（>）で構成されるシーケンスです。次に例を示します。

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

配列または他のベクター（異なるベース型を持つベクターなど）から 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 エレメント

パラメーターリストで指定されたベクターをこのベクター内のエレメントと連結して、新しいベクターを作成します。パラメーターリストのベクターのベース型またはサブタイプは、このベクターと同じものである必要があります。パラメーターを渡さない場合、返されるベクターは元のベクターの複製（浅い複製）になります。

パラメーター

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

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

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

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

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

    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 エレメント

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

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

ただし、Flash Professional を使用して、メインタイムライン上のフレームで関数を作成し、それを異なる 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 ランタイムはエラーをスローします。このランタイムエラーは、次のように関数を変数に割り当てることによって回避できます。

     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 エレメント

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

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

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

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

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

     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;

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

パラメーター

関連する API エレメント

単一のエレメントをベクターに挿入します。このメソッドは、コピーを作成しないで、ベクターを変更します。

パラメーター

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

パラメーター

関連する API エレメント

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

パラメーター

関連する API エレメント

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

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

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

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

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

     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 エレメント

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

関連する API エレメント

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

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

パラメーター

関連する API エレメント

単一のエレメントをベクターから削除します。このメソッドは、コピーを作成しないで、ベクターを変更します。

パラメーター

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

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

関連する API エレメント

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

パラメーターを渡さない場合、新しいベクターは元のベクターの複製（浅い複製）になります。両方のパラメーターに 0 を渡すと、元のベクターと同じ型の新しい空のベクターが作成されます。

パラメーター

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 ランタイムはエラーをスローします。このランタイムエラーは、次のように関数を変数に割り当てることによって回避できます。

     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（2 つの値を比較する関数またはソートオプションのセット）に従ってソートします。

このメソッドは 1 つのパラメーターを取ります。パラメーターは、次のいずれかになります。

• Vector のベース型（T）の引数を 2 つ取り、Number を返す関数。

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

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

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

• 次の値のビット単位の論理和（OR）となる数値です。
  • 1 または Array.CASEINSENSITIVE
  • 2 または Array.DESCENDING
  • 4 または Array.UNIQUESORT
  • 8 または Array.RETURNINDEXEDARRAY
  • 16 または Array.NUMERIC

  値が 0 の場合、ソートは以下の方法で実行されます。

  • ソートでは大文字と小文字が区別されます。Z は a よりも先になります。
  • 昇順にソートされます。a は b よりも先になります。
  • 配列はソート順を反映するように変更されます。同じソートフィールドを持つ複数のエレメントは、ソート済みの配列の中で連続的かつランダムに格納されます。
  • データ型に関係なく、すべてのエレメントがストリングとしてソートされます。例えば、"1" は "9" よりも小さいストリング値であるため、100 は 99 よりも先になります。

パラメーター

関連する API エレメント

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

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

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

パラメーター

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

関連する API エレメント

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

関連する API エレメント

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

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

パラメーター

関連する API エレメント