Actionscript 3 Entwicklerhandbuch

ACTIONSCRIPT 3.0 ENTWICKLERHANDBUCH
Verwenden von Arrays
Mithilfe eines Array-Objekts können Sie an jeder Indexposition ein Element erstellen. Dagegen ist es mit einem
Vector-Objekt nur möglich, eine vorhandene Indexposition oder der nächsten verfügbaren Indexposition einen Wert
zuzuweisen. Die nächste verfügbare Indexposition entspricht der length-Eigenschaft des Vector-Objekts. Die
sicherste Methode, einem Vector-Objekt ein neues Element hinzuzufügen, wird im folgenden Codebeispiel
veranschaulicht:
myVector[myVector.length] = valueToAdd;
Mithilfe von drei Methoden der Array- und Vector-Klassen – push(), unshift() und splice() – können Sie
Elemente in ein indiziertes Array einfügen. Mit der push()-Methode werden ein oder mehrere Elemente am Ende
eines Arrays angehängt. Mit anderen Worten, das letzte mithilfe der push()-Methode in das Array eingefügte Element
weist die höchste Indexnummer auf. Mit der unshift()-Methode werden ein oder mehrere Elemente am Anfang
eines Arrays eingefügt, und zwar immer bei Indexposition 0. Mit der splice()-Methode wird eine beliebige Anzahl
von Elementen an einer bestimmten Indexposition in einem Array eingefügt.
Im folgenden Beispiel werden alle drei Methoden veranschaulicht. Ein Array namens planets wird erstellt, um die
Namen der Planeten in der Reihenfolge ihrer Nähe zur Sonne zu speichern. Als Erstes wird die push()-Methode
aufgerufen, um das erste Element, Mars, hinzuzufügen. Dann wird die unshift()-Methode aufgerufen, um das
Element Mercury (Merkur) am Anfang des Arrays einzufügen. Schließlich wird die splice()-Methode aufgerufen,
um die Elemente Venus und Earth (Erde) nach Mercury, jedoch vor Mars einzufügen. Mit dem ersten an splice()
übergebenen Argument, der Ganzzahl 1, wird angegeben, dass die Elemente an der Indexposition 1 eingefügt werden
sollen. Mit dem zweiten an splice() gesendeten Argument, der Ganzzahl 0, wird angegeben, dass keine Elemente
gelöscht werden sollen. Bei dem dritten und vierten Argument, Venus und Earth, die an splice() gesendet werden,
handelt es sich um die einzufügenden Elemente.
var planets:Array = new Array();
planets.push("Mars"); // array contents: Mars
planets.unshift("Mercury"); // array contents: Mercury,Mars
planets.splice(1, 0, "Venus", "Earth");
trace(planets); // array contents: Mercury,Venus,Earth,Mars
Mit den Methoden push() und unshift() wird jeweils eine vorzeichenlose Ganzzahl zurückgegeben, die die Länge
des geänderten Arrays angibt. Wenn die splice()-Methode zum Einfügen von Elementen verwendet wird, wird ein
leeres Array zurückgegeben. Dies ist auf die Vielseitigkeit der splice()-Methode zurückzuführen. Sie können die
splice()-Methode nicht nur zum Einfügen von Elementen in ein Array, sondern auch zum Entfernen von
Elementen aus einem Array verwenden. Wenn die splice()-Methode zum Entfernen von Elementen verwendet
wird, wird ein Array mit den entfernten Elementen zurückgegeben.
Hinweis: Wenn die fixed-Eigenschaft eines Vector-Objekts auf true eingestellt ist, kann die Gesamtanzahl der
Elemente im Vektor sich nicht ändern. Wenn Sie versuchen, einem Vector-Objekt mit fester Länge mithilfe der hier
beschriebenen Verfahren ein neues Element hinzuzufügen, tritt ein Fehler auf.
Abrufen von Werten und Entfernen von Array-Elementen
Flash Player 9 und höher, Adobe AIR 1.0 und höher
Am einfachsten können Sie den Wert eines Elements aus einem indizierten Array abrufen, indem Sie den Array-
Zugriffsoperator ([]) verwenden. Um den Wert eines Elements in einem indizierten Array abzurufen, verwenden Sie
den Namen des Array- oder Vector-Objekts und die Indexnummer auf der rechten Seite einer Zuweisungsanweisung:
var myFavoriteSong:String = songTitles[3];
Es kann versucht werden, den Wert von einem Array- oder Vector-Objekt mithilfe eines Indexes abzurufen, an dem
keine Elemente existieren. In diesem Fall gibt ein Array-Objekt den Wert „undefined“ zurück und ein Vector-Objekt
gibt eine RangeError-Ausnahme aus.
Letzte Aktualisierung 27.6.2012
32