# Splice proc (list)

Source: https://ref.dm-lang.org/list/proc/Splice
Added in BYOND 514.

### Format
> `list.Splice(Start=1,End=0,Item1,Item2...)`

### Args
- `Start`: The list index where the splice will begin.
- `End`: The index immediately following the last item to be cut from the list. 0 is the end of the list.
- `Item1, Item2...`: Items to be inserted.


Cuts out items from a list, and inserts new items in their place. This is basically equivalent to calling `list.Cut(Start,End)` and then calling `list.Insert(Start,Item1,Item2...)`, but faster.

```dm /Splice/
var/list/L = list("apple","banana","orange","pear")

// cuts "banana" and "orange" and inserts four new items
L.Splice(2,4,"firetruck","camel","joystick","balloon")

// prints apple, firetruck, camel, joystick, balloon, pear
for(var/item in L)
    usr << item
```

As with `Insert()`, any items that are lists will insert their contents instead of themselves.

The `Start` and `End` index values can be negative, which count backwards from the end of the list. If the index values are out of range, there will be no error; they will simply be clamped to the beginning or end of the list. If `End` comes before `Start`, the two values are swapped.

> [!note]
> 
> This proc doesn't work with many special lists such as `contents` or `overlays`.

### See also
- [Copy proc (list)](https://ref.dm-lang.org/list/proc/Copy.md)
- [Cut proc (list)](https://ref.dm-lang.org/list/proc/Cut.md)
- [Insert proc (list)](https://ref.dm-lang.org/list/proc/Insert.md)
- [splicetext proc](https://ref.dm-lang.org/proc/splicetext.md)