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 與這個 Vector 中的元素連接，並建立新的 Vector。參數清單中的 Vector 必須具有與這個 Vector 相同的基底類型或子類型。如果您沒有傳遞任何參數，傳回的 Vector 便會是原始 Vector 的重製副本 (陰影副本)。

參數

針對 Vector 中的每個項目執行測試函數，直到到達針對指定之函數傳回 false 的項目為止。您可以使用此方法，判斷 Vector 中的所有項目是否符合準則，如具有小於特定數字的值。

對於此方法而言，如果第一個參數 callback 是方法結束項，第二個參數 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 是方法結束項，第二個參數 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 是方法結束項，第二個參數 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 是方法結束項，第二個參數 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。傳回的 Vector 包含 startIndex 元素及其後的所有元素，但是不包含 endIndex 元素。

如果您沒有傳遞任何參數，新的 Vector 便會是原始 Vector 的重製副本 (陰影副本)。如果您對這兩個參數傳遞 0 值，則會建立與原始 Vector 相同類型的新空白 Vector。

參數

針對 Vector 中的每個項目執行測試函數，直到到達傳回 true 的項目為止。您可以使用此方法，判斷 Vector 中的所有項目是否符合準則，如具有小於特定數字的值。

對於此方法而言，如果第一個參數 callback 是方法結束項，第二個參數 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 的前面，其值為負值
  • 如果 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 之前)。
  • 陣列會遭到修改，以反映出排序順序；具有相同排序欄位的多個元素會被連續置於排序陣列中 (不會依照特定順序)。
  • 所有的元素，無論屬於何種資料類型，都會如字串般排序。所以 100 會在 99 之前，因為 "1" 是比 "9" 低的字串值。

參數

相關 API 元素

在 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 元素