Skip to content

Latest commit

 

History

History
478 lines (339 loc) · 7.83 KB

table.md

File metadata and controls

478 lines (339 loc) · 7.83 KB

罗技宏框架扩展方法(Table篇)

方法列表：

table.some

table.some() 方法判断数组中是否存在符合条件的项。

参数列表

  • table - 目标数组。
  • function - 判断方法，接受两个参数(n, i)。
    • n - 数组中的每一项。
    • i - 当前项的下标。

返回值

  • boolean - 满足则返回 true，否则返回 false

备注信息

无

代码示范

local list = { 1, 2, 3, 4, 5 }
-- list 中存在比3大的数字
local res1 = table.some(list, function (n, i)
  return n > 3
end)
console.log(res1) -- true

-- list 中存在比5大的数字
local res2 = table.some(list, function (n, i)
  return n > 5
end)
console.log(res2) -- false

table.every

table.every() 方法判断数组中是否所有项都满足条件。

参数列表

  • table - 目标数组。
  • function - 判断方法，接受两个参数(n, i)。
    • n - 数组中的每一项。
    • i - 当前项的下标。

返回值

  • boolean - 满足则返回 true，否则返回 false

备注信息

无

代码示范

local list = { 1, 2, 3, 4, 5 }
-- list 中所有数字都比10小
local res1 = table.every(list, function (n, i)
  return n < 10
end)
console.log(res1) -- true

-- list 中所有数字都比5小
local res2 = table.every(list, function (n, i)
  return n < 5
end)
console.log(res2) -- false

table.reduce

table.reduce() 方法对数组中的每个元素执行一个由您提供的 table.reduce 函数(升序执行)，将其结果汇总为单个返回值。

参数列表

  • table - 目标数组。
  • function - 处理方法，接受两个参数(n, m)。
    • n - 第一轮循环为第一项，之后的循环为前一轮循环的返回值。
    • i - 当前循环数+1的下标项。

返回值

  • any - 返回处理后的值。

备注信息

无

代码示范

local list = { 1, 2, 3, 4, 5 }
-- 计算 list 数组中所有数字之和
local res1 = table.reduce(list, function (n, m)
  return n + m
end)
console.log(res1) -- 15

local strs = { "LMF", "is", "the", "best", "Logitech", "macro", "framework!" }
-- 连接 strs 中的字符串，字符串之间用空格连接
local res2 = table.reduce(strs, function (n, m)
  return n .. " " .. m
end)
console.log(res2)

-- "LMF is the best Logitech macro framework!"

table.map

table.map() 方法创建一个新数组，其结果是该数组中的每个元素都调用一个提供的函数后返回的结果。

参数列表

  • table - 目标数组。
  • function - 处理方法，接受两个参数(n, i)。
    • n - 数组中的每一项。
    • i - 当前项的下标。

返回值

  • table - 处理后的新数组

备注信息

该方法不会改变原始数组。

代码示范

local list = { 1, 2, 3, 4, 5 }
-- 返回一个项是 list 中每一项的平方的新数组
local res = table.map(list, function (n, i)
  return n * n
end)
console.log(res)

-- { 1, 4, 9, 16, 25 }

table.forEach

table.forEach() 方法对数组的每个元素执行一次提供的函数。

参数列表

  • table - 目标数组。
  • function - 处理方法，接受两个参数(n, i)。
    • n - 数组中的每一项。
    • i - 当前项的下标。

返回值

无

备注信息

无

代码示范

local list = { 1, 2, 3, 4, 5 }
-- 输出 list 数组中的每一项
table.forEach(list, function (n, i)
  console.log(n)
end)

-- 1
-- 2
-- 3
-- 4
-- 5

table.createFill

table.createFill() 方法用于快速创建一个指定长度且每一项值相同的数组。

参数列表

  • number - 指定数组长度。
  • any - 指定数组项的值。

返回值

  • table - 创建的数组

备注信息

无

代码示范

-- 创建一个长度是20值为0的数组
local res = table.createFill(20, 0)
console.log(res)

-- { 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0 }

table.print

table.print() 方法将任意类型变量格式化成字符串形式。

参数列表

  • any - 任意类型的变量。

返回值

  • string - 格式化后的字符串。

备注信息

console.log 方法会调用 table.print 方法处理传入的值，并自动在末尾加上换行符 \n ，然后使用 logMsg 方法将文本信息输出到控制台。

代码示范

local v = { 1, 2, "", true, false }
console.log(v)

-- { 1, 2, "", true, false }

table.push

table.push() 方法将值添加值数组的最后一项。

参数列表

  • table - 原始数组。
  • any - 被添加的项。

返回值

nil

备注信息

该方法会改变原始数组。

代码示范

local arr = { 1, 2, 3 }
table.push(arr, { a = 3 })
console.log(arr)

-- {
--      1,
--      2,
--      3,
--      {
--           a = 3
--      }
-- }

table.indexOf

table.indexOf() 方法查询该项在数组中的下标。

参数列表

  • table - 查询数组。
  • any - 被查询的项。

返回值

  • number - 下标，不存在时返回 -1

备注信息

不存在时返回 -1

代码示范

local arr = { 1, 2, 5, 8, 7, 6, 4 }
console.log(
	table.indexOf(arr, 5)
)

-- 3

table.merge

table.merge() 方法将多个 table 合并成一个新的 table。

参数列表

  • tables - 需要合并的 table，可以传入多个 table。

返回值

  • table - 合并后的 table

备注信息

该方法不会改变原 table，而是返回一个新的 table

代码示范

local t = {
	a = 1,
	b = 2,
	d = {
		da = 1,
		db = 2
	},
	e = { 1, 2, 5, 3, 6, 8, 9, 5, 3 }
}

local s = {
	a = 3,
	c = 3,
	d = {
		dc = 3,
	},
	e = { 1, 2, 3, 4, 5 }
}

console.log(
	table.merge(t, s)
)

-- {
--      a = 3,
--      c = 3,
--      b = 2,
--      e = { 1, 2, 3, 4, 5, 8, 9, 5, 3 },
--      d = {
--           db = 2,
--           dc = 3,
--           da = 1
--      }
-- }

table.cloneDeep

table.cloneDeep() 方法用于变量深度拷贝。

参数列表

  • any - 任意需要拷贝的值。

返回值

  • any - 返回拷贝后的值。

备注信息

修改通过该方法拷贝后获取的值，不会改变原始值。

代码示范

local t = {
	a = 1,
	b = 2,
	d = {
		da = 1,
		db = 2
	},
	e = { 1, 2, 5, 3, 6, 8, 9, 5, 3 }
}

local e = table.cloneDeep(t)
e.d = 3
console.log(e, t)

-- {
--      a = 1,
--      d = 3,
--      e = { 1, 2, 5, 3, 6, 8, 9, 5, 3 },
--      b = 2
-- }
-- {
--      a = 1,
--      d = {
--           db = 2,
--           da = 1
--      },
--      e = { 1, 2, 5, 3, 6, 8, 9, 5, 3 },
--      b = 2
-- }

table.find

table.find() 方法从数组中查找指定的项并返回该项

参数列表

  • table - 被查找的数组。
  • function - 查找方法。

返回值

  • any - 返回找到的项。

备注信息

返回的为引用值。

代码示范

local t = {
  { a = 1 },
  { a = 2 }
}

local _t = table.find(t, function (n, i)
  return n.a == 1
end)

console.log(_t)

-- {
--      a = 1
-- }

table.filter

table.filter() 方法从数组中筛选符合条件的项

参数列表

  • table - 被筛选的数组。
  • function - 筛选方法。

返回值

  • table - 返回筛选后的列表。

备注信息

返回的表中每一项皆为引用值。

代码示范

local t = {
  { a = 1 },
  { a = 2 },
  { a = 3 }
}

local _t = table.filter(t, function (n, i)
  return n.a < 3
end)

console.log(_t)

-- {
--      {
--           a = 1
--      },
--      {
--           a = 2
--      }
-- }