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,Borge Jani,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,Borge Jani,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,Borge Jani,Hege,Tove |