examples

Example

local tbl = {
  a = 4,
  b = function()
    print('go')
  end,
  c = 10
}
local tbl2 = table.clearForNui(tbl)
log(tbl2)
-- Expected output: tbl2 = {a = 4, c = 10}

Example

local tbl = {
  value = 5,
  children = {
    value = 6
  }
}
local tbl2 = table.copy(tbl)

Example

local tbl = { a = 3, b = 4 }
local count = table.count(tbl)
-- Expected output : 2

Example

local tbl = {
  name = "John",
  age = 30,
  city = "New York"
}
local name = table.extract(tbl, "name")
log(name)
-- Expected output: "John"
log(tbl)
-- Expected output: {age = 30, city = "New York"}

Example

local tbl = {
  a = 1,
  b = 2,
  c = 3
}
local filter = function(element, key, tble)
  if element < 2 then
    return false --remove tbl.a
  end
  if key == "c" then
    return false --remove tbl.c
  end
  return true
end
local tbl2 = table.filter(tbl, filter)
log(tbl2)
-- Expected output : tbl = {b=2}

Example

local tbl = [5, 12, 8, 130, 44];
local cb = function(element)
  return element > 10
end
local found = table.find(tbl,cb)
print(found)
-- Expected output : 12

Example

local table1 = { a = 1, b = 2, c = { d = 3 } }
local table2 = { a = 1, b = 2, c = { d = 3 } }
local table3 = { a = 1, b = 2 }

print(table.isEgal(table1, table2))
-- Expected output: true (tables are identical)

print(table.isEgal(table1, table3))
-- Expected output: false (strict comparison by default, table3 is missing key 'c')

print(table.isEgal(table1, table3, true, false, true))
-- Expected output: false (strict but allowing table1 keys to be missing in table3)

print(table.isEgal(table3, table1, true, true, false))
-- Expected output: true (strict but allowing table3 keys to be missing in table1)

Example

local tbl = { a = 10 }
print(table.isEmpty(tbl))
-- Expected output : false

Example

local tbl = { 1, 4, 9, 16 }
local cb = function(element)
  return element * 2
end
local tbl2 = table.map(tbl, cb)
log(tbl2)
-- Expected output : tbl2 = {2,8,18,32}

Example

local tbl1 = {
  a = 5,
  b = 2
}
local tbl2 = {
  a = 10,
  c = 3
}
local tbl3 = table.merge(tbl1, tbl2)
-- Expected output: tbl3 = { a=10, b=2, c=3 }

Example

local array1 = { 1, 2, 3 }
local array2 = { 4, 5, 6 }
local result = table.mergeAfter(array1, array2)
log(result)
-- Expected output: [1, 2, 3, 4, 5, 6]

-- Unlike table.merge which merges by keys
local tbl1 = { a = 1, b = 2 }
local tbl2 = { c = 3, d = 4 }
local mergeAfterResult = table.mergeAfter(tbl1, tbl2)
log(mergeAfterResult)
-- Expected output: {a = 1, b = 2, 1 = 3, 2 = 4}

Example

-- Injected inside a value
local value = {x=1}
table.addMultiLevels(value,"key","otherKey")
log(value)
-- Expected output: {"x":1,"key":{"otherKey": {}}}

-- Create a new value
local value = table.addMultiLevels("key","otherKey")
log(value)
-- Expected output: {"key":{"otherKey": {}}

Example

local tbl = { a = 1, b = { c = 2 } }
----
-- Simple table
----
print(table.doesKeyExist(tbl, "a")) -- Expected output: true
print(table.doesKeyExist(tbl, "f")) -- Expected output: false
----
-- Deep table
----
print(table.doesKeyExist(tbl, "b", "c")) -- Expected output: true
print(table.doesKeyExist(tbl, "b", "d")) -- Expected output: false
print(table.doesKeyExist(tbl, "b", "c", "d")) -- Expected output: false

Example

local tbl = { 1, 2, 3, 4, 5 }
print(table.includes(tbl, 3)) -- Expected output: true
print(table.includes(tbl, 3, 4)) -- Expected output: false because the index of `3` is lower than `fromIndex` (4) value
print(table.includes(tbl, 6)) -- Expected output: false

Example

local tbl = { 1, 2, 3, 4, 5 }
local tbl2 = table.slice(tbl, 2, 4)
log(tbl2)
-- Expected output : tbl2 = {2,3,4}

Example

local tbl = { a = 1, b = 2 }
table.upsert(tbl, "a", 10)
log(tbl)
-- Expected output: {a = 10, b = 2}
table.upsert(tbl, "c", 3)
log(tbl)
-- Expected output: {a = 10, b = 2, c = 3}

Example

local tbl = { a = 1, b = { c = 2, d = 3 } }
table.deleteDeepValue(tbl, "b", "c")
log(tbl)
-- Expected output: {a = 1, b = {d = 3}}