table.clone

Author: Sainan

docs/Runtime Environment/Table.md

@@ -397,6 +397,31 @@ print(test[2]) --> 5
 print(test[3]) --> 6
 ```
 
+---
+### `table.clone`
+Creates a copy of a table, optionally cloning nested tables up to a specified depth.
+#### Parameters
+1. The table to clone.
+2. The depth to clone to. Defaults to 100.
+#### Returns
+A new table containing the cloned values.
+```pluto
+local t = {
+    a = {
+        b = {
+            c = {},
+        },
+    },
+}
+
+local t1 = t:clone(1)
+assert(t1.a == t.a) -- depth 1 does not copy nested tables
+
+local t2 = t:clone(2)
+assert(t2.a ~= t.a)      -- 'a' is cloned
+assert(t2.a.b == t.a.b)  -- but 'b' is shared
+```
+
 ---
 ### `table.create`
 Creates a new empty table, preallocating memory. Improves performance and memory usage when you know how many elements the table will have.