Visit Mozilla.org

Dokumentacja języka JavaScript 1.5:Obiekty:Array:unshift

z Mozilla Developer Center, polskiego centrum programistów Mozilli.


Spis treści

[edytuj] Podsumowanie

Dodaje jeden lub więcej elementów na początek tablicy i zwraca jej nową długość.

Metoda obiektu: Array
Zaimplementowana w: JavaScript 1.2, NES 3.0
Wersja ECMA: ECMA-262 Edycja 3

[edytuj] Składnia

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

[edytuj] Parametry

element1, ..., elementN 
Elementy do dodania na początek tablicy.

[edytuj] Przykłady

[edytuj] Przykład: Dodawanie elementów do tablicy

Następujący kod wyświetli tablicę myFish przed i po dodaniu do niej elementów.

myFish = ["anioł", "klaun"];
document.writeln("myFish przed: " + myFish);
unshifted = myFish.unshift("bęben", "lew");
document.writeln("myFish po: " + myFish);
document.writeln("Nowa długość tablicy: " + unshifted);

Powyższy przykład wyświetli:

myFish przed: ["anioł", "klaun"]
myFish po: ["bęben", "lew", "anioł", "klaun"]
Nowa długość tablicy: 4

[edytuj] Zobacz także

pop, push, shift