Grimes at 22:50, 13 April 2018

2018-04-13T22:50:59Z

New page

{{Mission Scripting

|fName= mist.utils.deepCopy|

|vNum = Mist 1.0

|desc= This function returns a "deep copy" of table, "deep" in that the copy recursively progresses down all "levels" of the table, and the copy shares the same metatables as the passed-in table. This function also correctly handles tables with cycles. This function is quite often useful because tables are passed by reference in Lua, not by value. |

|rtnType= table

|reqType1= table

|reqName1= table

|reqType2=

|optType1=

|varExamples= any table

|rtnExamples= same as input table

|example= <code>
do
: newTable = mist.utils.deepCopy(originalTable)
end
</code>

|notes= This code is from [http://lua-users.org/wiki/CopyTable].

Explained Further in '''English''': If a variable is declared to equal a table, Lua does not create a new table, it instead
creates a new reference for the table. So now you have two references to the same table and
of course, any change made to one reference will apply to the other reference.
mist.utils.deepCopy gets around this by creating an entirely new table that is effectively a
"clone" of the other table.

|funcs= {{listOfMistUtils}}

}}
[[Category: MIST|deepCopy ]]

MIST deepCopy - Revision history

Grimes at 22:50, 13 April 2018