unshift (Array.unshift-Methode)

public unshift(value:Object) : Number

Fügt am Anfang 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 - Eine oder mehrere Zahlen, Elemente oder Variablen, die am Anfang des Arrays eingefügt werden sollen.

Rückgabewerte

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

Beispiel

Aus dem folgenden Beispiel geht die Verwendung der Array.unshift()-Methode hervor:

var pets_array:Array = new Array("dog", "cat", "fish");
trace( pets_array ); // Anzeige: dog,cat,fish
pets_array.unshift("ferrets", "gophers", "engineers");
trace( pets_array ); // Anzeige: ferrets,gophers,engineers,dog,cat,fish

Siehe auch

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