push (Array.push-Methode)

public push(value:Object) : Number

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

Verfügbarkeit: ActionScript 1.0, Flash Lite 2.0

Parameter

value:Object - Ein oder mehrere Werte, die an das Array angehängt werden.

Rückgabewerte

Number - Eine Ganzzahl, die die Länge des neuen Arrays angibt.

Beispiel

Im folgenden Beispiel wird das Array myPets_array mit den zwei Elementen cat und dog erstellt: In der zweiten Zeile werden zwei Elemente zum Array hinzugefügt.

Da die push()-Methode die neue Länge des Arrays zurückgibt, schreibt die trace()-Anweisung in der letzten Zeile die neue Länge von myPets_array (4) in das Bedienfeld Ausgabe.

var myPets_array:Array = new Array("cat", "dog");
var pushed:Number = myPets_array.push("bird", "fish");
trace(pushed); // Anzeige: 4

Siehe auch

pop (Array.pop-Methode), shift (Array.shift-Methode), unshift (Array.unshift-Methode)