Vector  - AS3

Zeigt an, ob die length-Eigenschaft des Vectors geändert werden kann. Wenn der Wert true ist, kann die length-Eigenschaft nicht geändert werden. Dies bedeutet, dass die folgenden Vorgänge nicht zulässig sind, wenn fixed dem Wert true entspricht:

• direktes Festlegen der length-Eigenschaft
• Zuweisen eines Wertes zur Indexposition length
• Aufrufen einer Methode, die die length-Eigenschaft ändert, einschließlich:
  • pop()
  • push()
  • shift()
  • unshift()
  • splice() (wenn der splice()-Aufruf den length-Wert des Vectors ändert).

Der Bereich der gültigen Indexpositionen, die im Vector verfügbar sind. Eine Vector-Instanz hat Indexpositionen bis zum length-Wert, schließen diesen jedoch nicht ein.

Jedes Vector-Element hat immer einen Wert, der eine Instanz des Basistyps oder null ist. Wenn für die length-Eigenschaft ein Wert festgelegt wird, der größer als der vorhergehende ist, werden zusätzliche Elemente erstellt und mit dem Standardwert gefüllt, der dem Basistyp (null für Verweistypen) entspricht.

Wenn für die length-Eigenschaft ein Wert festgelegt wird, der kleiner als der vorhergehende ist, werden alle Elemente in den Indexpositionen, die größer oder gleich dem neuen length-Wert sind, vom Vector entfernt.

Erstellt einen Vector mit dem festgelegten Basistyp.

Beim Aufrufen des Vector.<T>()-Konstruktors legen Sie den Basistyp mithilfe der Syntax des type-Parameters fest. Die Syntax des type-Parameters ist eine Sequenz, die einen Punkt (.), eine linke spitze Klammer (<), einen Klassennamen, dann eine rechte spitze Klammer (>) enthält, wie in diesem Beispiel angezeigt:

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

Um eine Vector-Instanz aus einem Array oder einem anderen Vector (z. B. einem Vector mit einem unterschiedlichen Basistypen) zu erstellen, verwenden Sie die globale Vector()-Funktion.

Um eine bereits mit Werten versehene Vector-Instanz zu erstellen, verwenden Sie die folgende Syntax anstatt der unten angegebenen Parameter:

     // var v:Vector.<T> = new <T>[E0, ..., En-1 ,];
     // For example: 
     var v:Vector.<int> = new <int>[0,1,2,];
     

Für diese Syntax gelten die folgenden Informationen:

• Sie wird in Flash Professional CS5 und höher, Flash Builder 4 und höher sowie Flex 4 und höher unterstützt.
• Das nachgestellte Komma ist optional.
• Leere Elemente im Array werden nicht unterstützt; eine Anweisung wie var v:Vector.<int> = new <int>[0,,2,] führt zu einem Compilerfehler.
• Sie können keine Standardlänge für die Vektorinstanz festlegen. Stattdessen ist die Länge mit der Anzahl der Elemente in der Initialisierungsliste identisch.
• Sie können nicht angeben, ob die Vector-Instanz eine feste Länge hat. Verwenden Sie stattdessen die fixed-Eigenschaft.
• Datenverluste oder -fehler können auftreten, wenn Elemente, die als Werte übergeben wurden, nicht dem angegebenen Typ entsprechen. Beispiel:

     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
     

Verwandte API-Elemente

Verkettet die in den Parametern angegebenen Vektoren mit den Elementen in diesem Vektor und erstellt einen neuen Vektor. Die Vektoren in der Parameterliste müssen denselben Basistyp oder Untertyp wie dieser Vektor haben. Wenn Sie keine Parameter übergeben, wird der zurückgegebene Vektor als Duplikat („Shallow Clone“) des ursprünglichen Vektors erstellt.

Parameter

Führt für jedes Element im Vector eine Testfunktion aus, bis ein Element erreicht wird, das für die festgelegte Funktion false zurückgibt. Sie verwenden diese Methode, um zu ermitteln, ob alle Elemente in einem Vector ein Kriterium erfüllen, z. B. dass die Werte unter einer bestimmten Zahl liegen.

Für diese Methode muss der zweite Parameter (thisObject) den Wert null haben, wenn der erste Parameter (callback) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.

Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen this-Kontext aufrufen möchten:

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

Nehmen Sie weiter an, dass Sie dann die every()-Methode bei einem Vector mit dem Namen myVector verwenden:

    myVector.every(myFunction, someObject);
    

Da myFunction ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen this-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:

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

Parameter

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

Verwandte API-Elemente

Führt für jedes Element im Vector eine Testfunktion aus und erstellt einen neuen Vector für alle Elemente, die für die festgelegte Funktion true zurückgeben. Wenn ein Element false zurückgibt, ist es nicht im Ergebnisvektor enthalten. Der Basistyp des Rückgabevektors stimmt mit dem Basistyp des Vectors überein, bei dem die Methode aufgerufen wurde.

Für diese Methode muss der zweite Parameter (thisObject) den Wert null haben, wenn der erste Parameter (callback) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.

Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen this-Kontext aufrufen möchten:

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

Nehmen Sie weiter an, dass Sie dann die filter()-Methode bei einem Vector mit dem Namen myVector verwenden:

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

Da myFunction ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen this-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:

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

Parameter

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

Verwandte API-Elemente

Führt für jedes Element im Vector eine Funktion aus.

Für diese Methode muss der zweite Parameter (thisObject) den Wert null haben, wenn der erste Parameter (callback) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.

Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen this-Kontext aufrufen möchten:

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

Nehmen Sie weiter an, dass Sie dann die forEach()-Methode bei einem Vector mit dem Namen myVector verwenden:

     myVector.forEach(myFunction, someObject);
     

Da myFunction ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen this-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:

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

Parameter

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

Sucht nach einem Element im Vector und gibt die Indexposition des Elements zurück. Das Element wird mit dem Operator für strikte Gleichheit (===) verglichen.

Parameter

Verwandte API-Elemente

Fügen Sie ein einzelnes Element in den Vektor ein. Bei dieser Methode werden Änderungen am Vektor vorgenommen, ohne eine Kopie zu erstellen.

Parameter

Wandelt die Elemente in einem Vector in Strings um, fügt zwischen ihnen das festgelegte Trennzeichen ein, verkettet die Elemente und gibt den Ergebnisstring zurück. Ein verschachtelter Vector wird immer durch ein Komma (,) getrennt und nicht durch das Trennzeichen, das an die join()-Methode übergeben wurde.

Parameter

Verwandte API-Elemente

Sucht nach einem Element im Vector, wobei von der festgelegten Indexposition nach hinten gesucht wird und gibt dann die Indexposition des übereinstimmenden Elements zurück. Das Element wird mit dem Operator für strikte Gleichheit (===) verglichen.

Parameter

Verwandte API-Elemente

Führt eine Funktion in jedem Element des Vectors aus und gibt einen neuen Vector mit Elementen zurück, die den Ergebnissen des Funktionsaufrufs in jedem Element dieses Vectors entsprechen. Der Ergebnisvektor hat den gleichen Basistyp und length-Wert wie der ursprüngliche Vector. Das Element an der Indexposition i im Ergebnisvektor ist das Ergebnis des Elementaufrufs an der Indexposition i im ursprünglichen Vector.

Für diese Methode muss der zweite Parameter (thisObject) den Wert null haben, wenn der erste Parameter (callback) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.

Nehmen Sie an, dass Sie mit Flash Professional eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen this-Kontext aufrufen möchten:

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

Nehmen Sie weiter an, dass Sie dann die map()-Methode bei einem Vector mit dem Namen myVector verwenden:

     myVector.map(myFunction, someObject);
     

Da myFunction ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen this-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:

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

Parameter

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

Verwandte API-Elemente

Entfernt das letzte Element aus einem Vector und gibt dieses Element zurück. Die length-Eigenschaft des Vectors verringert sich um eins, wenn diese Funktion aufgerufen wird.

Verwandte API-Elemente

Fügt am Ende eines Vectors ein oder mehrere Elemente hinzu und gibt die neue Länge des Vectors zurück.

Da diese Funktion mehrere Argumente akzeptieren kann, wird der Datentyp der Argumente während des Kompilierens auch im Strict-Modus nicht überprüft. Wird jedoch ein Argument übergeben, das keine Instanz des Basistyps ist, tritt zur Laufzeit eine Ausnahme auf.

Parameter

Verwandte API-Elemente

Entfernen Sie ein einzelnes Element aus dem Vektor. Bei dieser Methode werden Änderungen am Vektor vorgenommen, ohne eine Kopie zu erstellen.

Parameter

Kehrt die Reihenfolge der Elemente im Vector um. Diese Methode ändert den Vector, über den sie aufgerufen wurde.

Entfernt das erste Element aus einem Vector und gibt dieses Element zurück. Die verbleibenden Vector-Elemente werden von ihrer ursprünglichen Position i nach i-1 verschoben.

Verwandte API-Elemente

Gibt einen neuen Vector zurück, der aus mehreren Elementen des ursprünglichen Vectors besteht, ohne dabei den ursprünglichen Vector zu ändern. Der zurückgegebene Vector beinhaltet das startIndex-Element und alle Elemente bis zum endIndex-Element, schließt dieses jedoch nicht ein.

Wenn Sie keine Parameter übergeben, wird der neue Vektor als Duplikat („Shallow Clone“) des ursprünglichen Vektors erstellt. Wenn Sie den Wert 0 für beide Parameter übergeben, wird ein neuer, leerer Vektor desselben Typs wie der ursprüngliche Vektor erstellt.

Parameter

Führt für jedes Element im Vector eine Testfunktion aus, bis ein Element erreicht wird, das true zurückgibt. Verwenden Sie diese Methode, um festzustellen, ob alle Elemente in einem Vector ein Kriterium erfüllen, z. B. dass die Werte unter einer bestimmten Zahl liegen.

Für diese Methode muss der zweite Parameter (thisObject) den Wert null haben, wenn der erste Parameter (callback) ein Methodenabschluss ist. Dies ist der gebräuchlichste Weg zur Verwendung dieser Methode.

Nehmen Sie an, dass Sie eine Funktion in einem Bild auf der Hauptzeitleiste erstellen, diese jedoch in einem anderen this-Kontext aufrufen möchten:

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

Nehmen Sie weiter an, dass Sie dann die some()-Methode bei einem Vector mit dem Namen myVector verwenden:

     myVector.some(myFunction, someObject);
     

Da myFunction ein Mitglied der Hauptklasse der SWF-Datei ist, kann sie nicht in einem anderen this-Kontext ausgeführt werden. Flash-Laufzeitumgebungen geben eine Ausnahme aus, wenn dieser Code ausgeführt wird. Sie können diesen Laufzeitfehler vermeiden, indem Sie die Funktion wie folgt einer Variable zuweisen:

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

Parameter

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

Verwandte API-Elemente

Sortiert die Elemente im Vector-Objekt und gibt auch ein sortiertes Vector-Objekt zurück. Diese Methode sortiert anhand des sortBehavior-Parameter, der entweder eine Funktion ist, die zwei Werte vergleicht, oder ein Satz von Sortieroptionen.

Diese Methode verwendet einen Parameter. Der Parameter kann einer der folgenden sein:

• eine Funktion, die zwei Argumente des Basistyps (T) des Vector-Objekts verwendet und einen Number-Wert zurückgibt:

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

  Die Logik der Funktion besteht darin, bei zwei gegebenen Elementen x und y einen der drei folgenden Werte zurückzugeben:

  • Eine negative Zahl, wenn x vor y in der sortierten Sequenz eingeblendet werden sollte
  • 0, wenn x und y einander entsprechen
  • Eine positive Zahl, wenn x in der sortierten Sequenz nach y eingeblendet werden soll

• eine Zahl, die ein „bitweises OR“ der folgenden Werte ist:
  • 1 oder Array.CASEINSENSITIVE
  • 2 oder Array.DESCENDING
  • 4 oder Array.UNIQUESORT
  • 8 oder Array.RETURNINDEXEDARRAY
  • 16 oder Array.NUMERIC

  Wenn der Wert 0 ist, erfolgt die Sortierung auf folgende Weise:

  • Bei der Sortierung wird Groß-/Kleinschreibung beachtet (Z kommt vor a).
  • Die Sortierung erfolgt aufsteigend (a kommt vor b).
  • Das Array wird entsprechend der Sortierreihenfolge geändert. Elemente mit identischen Sortierfeldern werden im sortierten Array ohne bestimmte Reihenfolge nacheinander platziert.
  • Alle Elemente werden, unabhängig von ihrem Datentyp, so sortiert, als seien sie Strings. 100 kommt demnach vor 99, da „1“ ein kleinerer Stringwert ist als „9“.

Parameter

Verwandte API-Elemente

Fügt einem Vector Elemente hinzu bzw. entfernt diese. Bei dieser Methode werden Änderungen am Vector vorgenommen, ohne eine Kopie zu erstellen.

Hinweis: Um diese Methode in einer Vector-Unterklasse zu überschreiben, verwenden Sie, wie im folgenden Beispiel gezeigt, ...args für die Parameter:

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

Parameter

Gibt einen String zurück, der die Elemente im angegebenen Vector repräsentiert. Alle Vector-Elemente von der Indexposition 0 bis zur höchsten Indexposition werden in einen verketteten, durch Kommas getrennten String konvertiert. In der ActionScript 3.0-Implementierung gibt diese Methode den gleichen Wert wie die Vector.toString()-Methode zurück.

Verwandte API-Elemente

Gibt einen String zurück, der die Elemente im Vector repräsentiert. Alle Vector-Elemente von der Indexposition 0 bis zur höchsten Indexposition werden in einen verketteten, durch Kommas getrennten String konvertiert. Verwenden Sie die Vector.join()-Methode, um ein benutzerdefiniertes Trennzeichen festzulegen.

Verwandte API-Elemente

Fügt am Beginn eines Vectors ein oder mehrere Elemente hinzu und gibt die neue Länge des Vectors zurück. Die anderen Elemente in diesem Vector werden von ihrer ursprünglichen Position i nach i + der Anzahl der neuen Elemente verschoben.

Da diese Funktion mehrere Argumente akzeptieren kann, wird der Datentyp der Argumente während des Kompilierens auch im Strict-Modus nicht überprüft. Wird jedoch ein Argument übergeben, das keine Instanz des Basistyps ist, tritt zur Laufzeit eine Ausnahme auf.

Parameter

Verwandte API-Elemente