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

Un article de MDC.

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

[modifier] Résumé

Retire le premier élément d'un tableau et renvoie cet élément. Cette méthode modifie la longueur du tableau.

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

[modifier] Syntaxe

var premierElement = array.shift();

[modifier] Paramètres

Aucun.

[modifier] Exemples

[modifier] Exemple : retrait d'un élément d'un tableau

Le code qui suit affiche le tableau mesPoissons avant et après la suppression de son premier élément. Il affiche également l'élément retiré :

// suppose qu'une fonction print a été définie
var mesPoissons = ["ange", "clown", "mandarin", "chirurgien"];
print("mesPoissons avant : " + mesPoissons);
var shifted = mesPoissons.shift();
print("mesPoissons après : " + mesPoissons);
print("Élément retiré : " + shifted);

Cet exemple affichera les lignes suivantes :

mesPoissons avant : ["ange", "clown", "mandarin", "chirurgien"]
mesPoissons après : ["clown", "mandarin", "chirurgien"]
Élément retiré : ange

[modifier] Voir aussi

pop, push, unshift.