Definition and Usage
The splice() method is used to remove and add new elements to an array.
Syntax
arrayObject.splice(index,howmany,element1,.....,elementX) |
| Parameter | Description |
| index | Required. Specify where to add/remove elements. Must be a number |
| howmany | Required Specify how many elements should be removed. Must be a number, but can be "0" |
| element1 | Optional. Specify a new element to add to the array |
| elementX | Optional. Several elements can be added |
Example
In this example we will create an array and add an element to it:
<script type="text/javascript">var arr = new Array(5);arr[0] = "Jani";arr[1] = "Hege";arr[2] = "Stale";arr[3] = "Kai Jim";arr[4] = "Borge";document.write(arr + "<br />");arr.splice(2,0,"Lene");document.write(arr + "<br />");</script> |
The output of the code above will be:
Jani,Hege,Stale,Kai Jim,BorgeJani,Hege,Lene,Stale,Kai Jim,Borge |
Example
In this example we will remove the element at index 2 ("Stale"), and add a new element ("Tove") there instead:
<script type="text/javascript">var arr = new Array(5);arr[0] = "Jani";arr[1] = "Hege";arr[2] = "Stale";arr[3] = "Kai Jim";arr[4] = "Borge";document.write(arr + "<br />");arr.splice(2,1,"Tove");document.write(arr);</script> |
The output of the code above will be:
Jani,Hege,Stale,Kai Jim,BorgeJani,Hege,Tove,Kai Jim,Borge |
Example
In this example we will remove three elements starting at index 2 ("Stale"), and add a new element ("Tove") there instead:
<script type="text/javascript">var arr = new Array(5);arr[0] = "Jani";arr[1] = "Hege";arr[2] = "Stale";arr[3] = "Kai Jim";arr[4] = "Borge";document.write(arr + "<br />");arr.splice(2,3,"Tove");document.write(arr);</script> |
The output of the code above will be:
Jani,Hege,Stale,Kai Jim,BorgeJani,Hege,Tove |