PICO-8 Wiki
(Note that index is optional and, if not supplied, turns deli into pop)
Tag: Source edit
(ipairs)
Tag: Source edit
Line 26: Line 26:
 
* <code>[[Foreach|foreach()]]</code>
 
* <code>[[Foreach|foreach()]]</code>
 
* <code>[[Pairs|pairs()]]</code>
 
* <code>[[Pairs|pairs()]]</code>
  +
* <code>[[Ipairs|ipairs()]]</code>
 
[[Category:Reference]]
 
[[Category:Reference]]
 
[[Category:API]]
 
[[Category:API]]

Revision as of 10:46, 29 June 2021

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