1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
|
---
title: Array.prototype.splice()
slug: Web/JavaScript/Referencje/Obiekty/Array/splice
tags:
- Dokumentacja_JavaScript
- Dokumentacje
- JavaScript
- Wszystkie_kategorie
translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice
---
<div>{{JSRef}}</div>
<h2 id="Podsumowanie" name="Podsumowanie">Podsumowanie</h2>
<p>Zmienia zawartość tablicy, dodając nowe elementy podczas usuwania starych elementów.</p>
<h2 id="Sk.C5.82adnia" name="Sk.C5.82adnia">Składnia</h2>
<pre class="syntaxbox"><code><var>array</var>.splice(<var>start</var>, <var>deleteCount</var>[, <var>item1</var>[, <var>item2</var>[, ...]]])
</code></pre>
<h3 id="Parametry" name="Parametry">Parametry</h3>
<dl>
<dt><code>start</code></dt>
<dd>Indeks od którego rozpoczynamy modyfikację tablicy.</dd>
</dl>
<dl>
<dt><code>deleteCount</code></dt>
<dd>Liczba całkowita określająca liczbę starych elementów tablicy do usunięcia. Jeżeli <font face="Consolas, Monaco, Andale Mono, monospace">deleteCount</font> wynosi 0, nic nie zostanie usunięte. W tym przypadku należy podać co najmniej jeden nowy element. W przypadku gdy parametr <font face="Consolas, Monaco, Andale Mono, monospace">deleteCount</font> nie został podany (druga forma składni podana powyżej, która jest rozszerzeniem SpiderMonkey), wszystkie elementy o indeksach wyższych <code>lub równych index</code> są usuwane.</dd>
</dl>
<dl>
<dt><code>itemN</code></dt>
<dd>Elementy dodawane do tablicy. Jeżeli nie określimy żadnych elementów, <code>splice</code> usunie tylko podaną liczbę elementów.</dd>
</dl>
<h2 id="Opis" name="Opis">Opis</h2>
<p>Jeżeli podamy różną liczbę wstawianych elementów od liczby usuwanych elementów, tablica będzie posiadała inną długość po wywołaniu metody <code>splice</code>.</p>
<p>Metoda <code>splice</code> zwraca tablicę zawierającą usunięte elementy. Jeżeli usunięty został tylko jeden element, zwracana jest tablica jednoelementowa.</p>
<h2 id="Przyk.C5.82ady" name="Przyk.C5.82ady">Przykłady</h2>
<h3 id="Przyk.C5.82ad:_Zastosowanie_splice" name="Przyk.C5.82ad:_Zastosowanie_splice">Przykład: Zastosowanie <code>splice</code></h3>
<p>Następujący skrypt ilustruje użycie splice:</p>
<pre class="brush: js">myFish = ["anioł", "klaun", "mandarynka", "jesiotr"];
console.log("myFish: " + myFish);
removed = myFish.splice(2, 0, "bęben");
console.log("Po dodaniu 1: " + myFish);
console.log("Usunięty jest: " + removed);
removed = myFish.splice(3, 1)
console.log("Po usunięciu 1: " + myFish);
console.log("Usunięty jest: " + removed);
removed = myFish.splice(2, 1, "trąba")
console.log("Po zastąpieniu 1: " + myFish);
console.log("Usunięty jest: " + removed);
removed = myFish.splice(0, 2, "papuga", "zawilec", "niebieski")
console.log("Po zastąpieniu 2: " + myFish);
console.log("Usunięty jest: " + removed);
</pre>
<p>Ten skrypt wyświetli:</p>
<pre>myFish: ["anioł", "klaun", "mandarynka", "jesiotr"]
Po dodaniu 1: ["anioł", "klaun", "bęben", "mandarynka", "jesiotr"]
Usunięty jest: undefined
Po usunięciu 1: ["anioł", "klaun", "bęben, "jesiotr"]
Usunięty jest: mandarynka
Po zastąpieniu 1: ["anioł", "klaun", "trąba", "jesiotr"]
Usunięty jest: bęben
Po zastąpieniu 2: ["papuga", "zawilec", "niebieski", "trąba", "jesiotr"]
Usunięty jest: ["anioł", "klaun"]
</pre>
|
