--- title: Array.prototype.splice() slug: Web/JavaScript/Reference/Global_Objects/Array/splice tags: - Dizi - Referans - metod - prototip translation_of: Web/JavaScript/Reference/Global_Objects/Array/splice ---
splice()
metodu; bir Dizi'nin içeriklerini, diziye ait öğeleri kaldırarak veya yeni öğeler ekleyerek ve/veya mevcut öğeleri silerek değiştirir.
array.splice(başlangıç[, silinecekAdet[, item1[, item2[, ...]]]])
başlangıç
silinecekAdet
{{optional_inline}}silinecekAdet
belirlenmemiş ise, veya değeri dizi.uzunluk - başlangıç
'tan büyük ise (daha sade bir tanımı, başlangıç
başlayarak, Dizi'nde kalmış öğelerin toplam sayısından fazla ise), start
sayısından Dizi'nin sonuna kadar yer alan bütün öğeler silinecek.silinecekAdet
0 veya negatif ise, hiçbir öğe silinmeyecek. Bu durumda, en az yeni bir öğe tanımlamalısın (aşağı bkz.).item1, item2, ...
{{optional_inline}}başlangıç
indeksinden başlayarak. hiçbir öğe tanımlamaz isen, splice()
sadece Dizi'den öğeleri kaldıracak.Silinen öğeleri barındıran bir Dizi. Sadece bir öğe silinmiş ise, tek öğeli bir Dizi geri dönülecek. Hiçbir öğe silinmemiş ise, boş bir Dizi dönecek.
Sileceğin öğe sayısından farklı bir sayıda öğe tanımlıyorsan, çağrının sonunda Dizi farklı bir uzunluğa sahip olacak.
var myFish = ['angel', 'clown', 'mandarin', 'sturgeon']; var removed = myFish.splice(2, 0, 'drum'); // myFish dizi öğeleri ["angel", "clown", "drum", "mandarin", "sturgeon"] // silinen [], hiçbir öğe silinmedi
var myFish = ['angel', 'clown', 'drum', 'mandarin', 'sturgeon']; var removed = myFish.splice(3, 1); // silinen ["mandarin"] // myFish Dizi'si ["angel", "clown", "drum", "sturgeon"]
var myFish = ['angel', 'clown', 'drum', 'sturgeon']; var silinen = myFish.splice(2, 1, 'trumpet'); // myFish is ["angel", "clown", "trumpet", "sturgeon"] // silinen ["drum"]
var myFish = ['angel', 'clown', 'trumpet', 'sturgeon']; var silinen = myFish.splice(0, 2, 'parrot', 'anemone', 'blue'); // myFish is ["parrot", "anemone", "blue", "trumpet", "sturgeon"] // silinen ["angel", "clown"]
var myFish = ['parrot', 'anemone', 'blue', 'trumpet', 'sturgeon']; var silinen = myFish.splice(myFish.length - 3, 2); // myFish is ["parrot", "anemone", "sturgeon"] // silinen ["blue", "trumpet"]
var myFish = ['angel', 'clown', 'mandarin', 'sturgeon']; var silinen = myFish.splice(-2, 1); // myFish ["angel", "clown", "sturgeon"] // silinen ["mandarin"]
var myFish = ['angel', 'clown', 'mandarin', 'sturgeon']; var silinen = myFish.splice(2); // myFish ["angel", "clown"] // silinen ["mandarin", "sturgeon"]
Özellik | Durum | Yorum |
---|---|---|
{{SpecName('ES3')}} | {{Spec2('ES3')}} | Initial definition. Implemented in JavaScript 1.2. |
{{SpecName('ES5.1', '#sec-15.4.4.12', 'Array.prototype.splice')}} | {{Spec2('ES5.1')}} | |
{{SpecName('ES6', '#sec-array.prototype.splice', 'Array.prototype.splice')}} | {{Spec2('ES6')}} | |
{{SpecName('ESDraft', '#sec-array.prototype.splice', 'Array.prototype.splice')}} | {{Spec2('ESDraft')}} |
{{Compat("javascript.builtins.Array.splice")}}