Visit Mozilla.org

Référence de JavaScript 1.5 Core:Objets globaux:Array:push

Un article de MDC.


Sommaire

[modifier] Résumé

Ajoute un ou plusieurs éléments à la fin d'un tableau et renvoie la nouvelle longueur de celui-ci. Cette méthode modifie la longueur du tableau.

Méthode de Array
Implémentation : JavaScript 1.2, NES 3.0

JavaScript 1.3 : push renvoie la nouvelle longueur du tableau plutôt que le dernier élément ajouté.

Version ECMA : ECMA-262 Edition 3

[modifier] Syntaxe

push(element1, ..., elementN);

[modifier] Paramètres

element1, ..., elementN 
Les éléments à ajouter à la fin du tableau.

[modifier] Description

Le comportement de cette méthode push est semblable à la fonction push dans Perl 4. Notez que ce comportement est différent en Perl 5.

[modifier] Compatibilité avec les versions antérieures

[modifier] JavaScript 1.2

La méthode push renvoyait le dernier élément ajouté au tableau.

[modifier] Exemples

[modifier] Exemple : ajout d'éléments à un tableau

Le code qui suit crée un tableau monPoisson contenant deux éléments, puis en ajoute encore deux. Après exécution, taille contient 4. (En JavaScript 1.2, la variable contiendrait "lion".)

monPoisson = ["ange", "clown"];
taille = monPoisson.push("rouget", "lion");

[modifier] Voir aussi

pop, shift, unshift.