unshift (méthode Array.unshift)

public unshift(value:Object) : Number

Ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Paramètres

value:Object - Un ou plusieurs nombres, éléments ou variables à insérer au début du tableau.

Valeur renvoyée

Number - Un entier représentant la nouvelle longueur du tableau.

Exemple

L'exemple suivant illustre l'utilisation de la méthode Array.unshift() :

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

Voir aussi

pop (méthode Array.pop), push (méthode Array.push), shift (méthode Array.shift)