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

Un article de MDC.

Sommaire 1 Résumé 2 Syntaxe 3 Paramètres 4 Exemples 4.1 Exemple : ajout d'éléments à un tableau 5 Voir aussi

[modifier] Résumé

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

Méthode de Array
Implémentation :	JavaScript 1.2, NES 3.0
Version ECMA :	ECMA-262 Edition 3

[modifier] Syntaxe

arrayName.unshift(element1, ..., elementN);

[modifier] Paramètres

element1, ..., elementN 

Les éléments à ajouter en début de tableau.

[modifier] Exemples

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

Le code qui suit affiche le tableau mesPoissons avant et après y avoir ajouté des éléments.

mesPoissons = ["ange", "clown"];
document.writeln("mesPoissons avant : " + mesPoissons);
unshifted = mesPoissons.unshift("rouget", "lion");
document.writeln("mesPoissons après : " + mesPoissons);
document.writeln("Nouvelle longueur : " + unshifted);

Cet exemple affichera les lignes suivantes :

mesPoissons avant : ["ange", "clown"]
mesPoissons après : ["rouget", "lion", "ange", "clown"]
New length: 4

[modifier] Voir aussi

pop, push, shift.