wip
This commit is contained in:
@@ -0,0 +1,96 @@
|
||||
-- Import ------------------------------------------------------------------------------------------
|
||||
|
||||
local table = _G.table
|
||||
|
||||
|
||||
-- Private -----------------------------------------------------------------------------------------
|
||||
|
||||
local private = {}
|
||||
|
||||
--[[
|
||||
Add a value to the end of an array-like table.
|
||||
|
||||
Args:
|
||||
target:array - a table which is being used like an array (i.e., contiguous integer keys)
|
||||
value:any - the value to be appeneded to the array
|
||||
|
||||
Returns:
|
||||
the target table
|
||||
]]--
|
||||
function private.append(target, value)
|
||||
target[#target] = value
|
||||
return target
|
||||
end
|
||||
|
||||
--[[
|
||||
Performs a deep clone of a given table.
|
||||
|
||||
This function only clones regular keys, and makes no effort to preserve the metatables of the
|
||||
resulting tables. It also does not attempt to handle cycles among the given tables.
|
||||
|
||||
Args:
|
||||
source:table - the table to be cloned
|
||||
|
||||
Returns:
|
||||
a new table which the same keys and deeply copied values
|
||||
]]--
|
||||
function private.clone(source)
|
||||
if type(source) ~= "table" then return source end
|
||||
|
||||
local target = {}
|
||||
for key, value in pairs(source) do
|
||||
target[key] = private.clone(value)
|
||||
end
|
||||
|
||||
return target
|
||||
end
|
||||
|
||||
--[[
|
||||
Performs a shallow clone of a given table.
|
||||
|
||||
This is similar to `clone`, but it does not attempt to deeply copy the values of the given
|
||||
table, instead creating a new table with the same keys and values as the original.
|
||||
|
||||
Args:
|
||||
source:table - the table to be copied
|
||||
|
||||
Returns:
|
||||
a new table with the same keys and values as the original
|
||||
|
||||
]]--
|
||||
function private.copy(source)
|
||||
return private.merge({}, source)
|
||||
end
|
||||
|
||||
--[[
|
||||
Overwrite the contents of a target table with the values in one or more source tables.
|
||||
|
||||
Only those keys defined by one of the source tables will be overridden in the target table.
|
||||
Each successive source table in the given sequence may override values in the earlier source
|
||||
tables. This function only performs a shallow copy, so any objects in the source tables are only copied
|
||||
by reference. To create a brand new table with the merged contents of the following tables,
|
||||
provide nil as the first argument.
|
||||
|
||||
Args:
|
||||
target:table - a table whose values are to be overridden
|
||||
...:table - a sequence of one or more source tables whose keys are to be copied
|
||||
|
||||
Returns:
|
||||
the target table
|
||||
]]--
|
||||
function private.merge(target, ...)
|
||||
target = target or nil
|
||||
|
||||
for _, source in ipairs({...}) do
|
||||
for key, value in pairs(source) do
|
||||
target[key] = value
|
||||
end
|
||||
end
|
||||
|
||||
return target
|
||||
end
|
||||
|
||||
|
||||
-- Export ------------------------------------------------------------------------------------------
|
||||
|
||||
return private.merge({}, table, private)
|
||||
Reference in New Issue
Block a user