mozilla

Revision 569135 of Array.prototype.unshift()

  • Raccourci de la révision : JavaScript/Reference/Objets_globaux/Array/unshift
  • Titre de la révision : unshift
  • ID de la révision : 569135
  • Créé :
  • Créateur : teoli
  • Version actuelle ? Non
  • Commentaire JavaScript/Reference/Référence_JavaScript/Objets_globaux/Array/unshift JavaScript/Reference/Objets_globaux/Array/unshift

Contenu de la révision

 

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

Syntaxe

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

Paramètres

element1, ..., element N
Les éléments à ajouter en début de tableau.

Exemples

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

Voir aussi

pop, push, shift.

{{ languages( { "en": "en/Core_JavaScript_1.5_Reference/Global_Objects/Array/unshift", "ja": "ja/Core_JavaScript_1.5_Reference/Global_Objects/Array/unshift", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/Array/unshift" } ) }}

Source de la révision

<p>&nbsp;</p>
<h3 id="R.C3.A9sum.C3.A9" name="R.C3.A9sum.C3.A9">Résumé</h3>
<p>Ajoute un ou plusieurs éléments au début d'un tableau et renvoie la nouvelle longueur du tableau.</p>
<table class="fullwidth-table">
 <tbody>
  <tr>
   <td class="header" colspan="2">Méthode de <a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Array">Array</a></td>
  </tr>
  <tr>
   <td>Implémentation&nbsp;:</td>
   <td>JavaScript 1.2, NES 3.0</td>
  </tr>
  <tr>
   <td>Version ECMA&nbsp;:</td>
   <td>ECMA-262 Edition 3</td>
  </tr>
 </tbody>
</table>
<h3 id="Syntaxe" name="Syntaxe">Syntaxe</h3>
<p><code>arrayName.unshift(
 <i>
  element1</i>
 , ...,
 <i>
  elementN</i>
 ); </code></p>
<h3 id="Param.C3.A8tres" name="Param.C3.A8tres">Paramètres</h3>
<dl>
 <dt>
  <code>element1, ..., element
  <i>
   N</i>
  </code></dt>
 <dd>
  Les éléments à ajouter en début de tableau.</dd>
</dl>
<h3 id="Exemples" name="Exemples">Exemples</h3>
<h4 id="Exemple_:_ajout_d.27.C3.A9l.C3.A9ments_.C3.A0_un_tableau" name="Exemple_:_ajout_d.27.C3.A9l.C3.A9ments_.C3.A0_un_tableau">Exemple&nbsp;: ajout d'éléments à un tableau</h4>
<p>Le code qui suit affiche le tableau <code>mesPoissons</code> avant et après y avoir ajouté des éléments.</p>
<pre>
mesPoissons = ["ange", "clown"];
document.writeln("mesPoissons avant&nbsp;: " + mesPoissons);
unshifted = mesPoissons.unshift("rouget", "lion");
document.writeln("mesPoissons après&nbsp;: " + mesPoissons);
document.writeln("Nouvelle longueur&nbsp;: " + unshifted);
</pre>
<p>Cet exemple affichera les lignes suivantes&nbsp;:</p>
<pre>
mesPoissons avant&nbsp;: ["ange", "clown"]
mesPoissons après&nbsp;: ["rouget", "lion", "ange", "clown"]
New length: 4
</pre>
<h3 id="Voir_aussi" name="Voir_aussi">Voir aussi</h3>
<p><a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Array/pop"><code>pop</code></a>, <a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Array/push"><code>push</code></a>, <a href="fr/R%c3%a9f%c3%a9rence_de_JavaScript_1.5_Core/Objets_globaux/Array/shift"><code>shift</code></a>.</p>
<p>{{ languages( { "en": "en/Core_JavaScript_1.5_Reference/Global_Objects/Array/unshift", "ja": "ja/Core_JavaScript_1.5_Reference/Global_Objects/Array/unshift", "pl": "pl/Dokumentacja_j\u0119zyka_JavaScript_1.5/Obiekty/Array/unshift" } ) }}</p>
Revenir à cette révision