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