Add

2023-10-22T19:38:17Z

46.134.147.82:

{{ApiReference
|name=add
|shortdesc=Adds an element to the end of a sequence in a table.
|table||The table.
|value||The value to add.
|index|optional|The index for the value to be inserted.
|result=The <var>value</var> that was passed in.
}}
The <code>add()</code> function adds an element to a sequence in a table.

If an <var>index</var> is not supplied, it is assumed to be <code>#table+1</code> and the value is appended to the end of the table.

The <code>add()</code> function returns the object being added. You can ignore this return value if you don't need it.

A stack can be easily emulated by using <code>add(s,v)</code> to push and <code>[[Deli|v=deli(s)]]</code> to pop.

== Examples ==
<syntaxhighlight lang="lua">
t = {1, 5}
add(t, 7) -- t = {1, 5, 7}
add(t, 9) -- t = {1, 5, 7, 9}
add(t, 3, 2) -- t = {1, 3, 5, 7, 9}

-- used to create and keep track of all players
players = {}
function new_player(pad_index, name)
return add(players, {pad_index, name})
end
</syntaxhighlight>

== See also ==

* [[Lua]]
* [[Tables]]
* <code>[[All|all()]]</code>
* <code>[[Del|del()]]</code>
* <code>[[Deli|deli()]]</code>
* <code>[[Foreach|foreach()]]</code>
* <code>[[Pairs|pairs()]]</code>
* <code>[[IPairs|ipairs()]]</code>
[[Category:Reference]]
[[Category:API]]

Pico-8 Wiki - User contributions [en]

Add