push (méthode Array.push)

public push(value:Object) : Number

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

Disponibilité : ActionScript 1.0 ; Flash Lite 2.0

Paramètres

value:Object - Une ou plusieurs valeurs à ajouter au tableau.

Valeur renvoyée

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

Exemple

L'exemple suivant crée le tableau myPets_array incluant deux éléments, cat et dog. La deuxième ligne ajoute deux éléments au tableau.

Etant donné que la méthode push() renvoie la nouvelle longueur du tableau, l'instruction trace() de la dernière ligne envoie la nouvelle longueur du tableau myPets_array (4) vers le panneau Sortie.

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

Voir aussi

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