array_splice definition and usage
array_splice() function is similar to array_slice() function, selecting a series of elements in the array, but does not return them, but deletes them and replaces them with other values.
If the fourth argument is provided, those previously selected elements will be replaced by the array specified by the fourth argument.
The last generated array will be returned.
Syntax
array_splice(array,offset,length,array) Parameter Description
array Required. Specifies an array.
offset required. numerical value. If offset is positive, removal begins at the offset specified by this value in the input array. If offset is negative, removal begins at the offset specified by this value from the end of the input array.
length optional. numerical value. If this parameter is omitted, all parts of the array from offset to the end are removed. If length is specified and is positive, this many elements are removed. If length is specified and is negative, all elements from offset to length counting down from the end of the array are removed.
array The removed elements are replaced by elements in this array. If no values are removed, the element in this array is inserted at the specified position.
Tips and Notes
Tip: If the function does not remove any elements (length=0), the replacement array will be inserted from the position of the start parameter. (See Example 3)
Note: Keys in the substitution array are not retained.
Example 1