Revision Difference
table.Merge#527661
<function name="Merge" parent="table" type="libraryfunc">
<description>
Merges the contents of the second table with the content in the first one. The destination table will be modified.
See <page>table.Inherit</page>, which doesn't override existing values.
See also <page>table.Add</page>, which simply adds values of one table to another.
<note>This function will cause a stack overflow under certain circumstances.</note>⤶
</description>
<realm>Shared and Menu</realm>
<file line="73">lua/includes/extensions/table.lua</file>
<file line="81-L95">lua/includes/extensions/table.lua</file>
<args>
<arg name="destination" type="table">The table you want the source table to merge with</arg>
<arg name="source" type="table">The table you want to merge with the destination table</arg>
</args>
<rets>
<ret name="" type="table">Destination table</ret>
</rets>
</function>
<example>
<description>"Merges" the content of the second table with the first one, overwriting any matching key/value pairs in the destination with the source's version and prints the resulting merge.</description>
<code>
local destination = {[1] = "A", [2] = "Golden", [3] = "Apple"}
local source = {[1] = "Two", [2] = "Orange"}
table.Merge( destination, source )
PrintTable( destination )
</code>
<outputfixedwidth>Fixed width</outputfixedwidth>
<output>
1 = Two
2 = Orange
3 = Apple
</output>
</example>