Deli

From Pico-8 Wiki
Jump to navigation Jump to search
deli( table, [index] )
Removes the element at the given index of a sequence in a table.
table
The table.

index
The index for the value to be removed.

The deli() function removes the value at the given index of a sequence. All subsequent values in the sequence shift down by one slot to keep the sequence contiguous.

The deli() function returns the object being removed. This can be ignored, tested it to see if the removal was successful, or used as needed.

If the index is not supplied, it is assumed to be #table, meaning the last element in the sequence. This means a stack can be easily emulated by using add(s,v) to push and v=deli(s) to pop.

Example

t = {1, 2, 4, 3, 4}
deli(t, 5)  -- t = {1, 2, 4, 3}
deli(t, 3)  -- t = {1, 2, 3}

See also