[Lua基础]tinsert函数使用说明

在 Lua 4.0 中，tinsert 是一个用于操作表（table）的函数，主要用于向表中插入新元素。下面将详细说明该函数的特性，并配以示例代码来帮助理解。

tinsert 函数概述

tinsert 是一个用于向表中插入新元素的函数，具有以下特性：可以向表的指定位置插入元素，未指定位置时默认插入到末尾。

函数原型：

tinsert(table, value)  -- 向表末尾插入元素
tinsert(table, pos, value)  -- 向指定位置插入元素

• table：目标表。
• pos（可选）：插入的位置。如果不指定，默认是末尾位置。
• value：要插入的元素。

tinsert 函数示例

示例 1：向表末尾插入元素

在这个示例中，我们将向一个 CDK 列表中插入一个新的元素：

cdk_list = {"CDK1", "CDK2", "CDK3"}
tinsert(cdk_list, "CDK4")
for i = 1, getn(cdk_list) do
    print(i, cdk_list[i])
end
-- 输出：
-- 1 CDK1
-- 2 CDK2
-- 3 CDK3
-- 4 CDK4

示例 2：向指定位置插入元素

在这个示例中，我们将向一个等级列表中在指定位置插入新元素：

cdk_levels = {"Basic", "Advanced", "Pro", "Elite"}
tinsert(cdk_levels, 3, "Intermediate")  -- 在位置 3 插入 "Intermediate"
for i = 1, getn(cdk_levels) do
    print(i, cdk_levels[i])
end
-- 输出：
-- 1 Basic
-- 2 Advanced
-- 3 Intermediate
-- 4 Pro
-- 5 Elite

示例 3：数组与哈希表的区别

tinsert主要用于数组形式的表操作，对于哈希表无效。在下方的示例中，我们演示了向数组和哈希表中插入元素的效果：

-- 数组形式的表
array_table = {"item1", "item2", "item3"}
tinsert(array_table, "item4")  -- 插入到数组末尾
for i = 1, getn(array_table) do
    print(i, array_table[i])
end
-- 输出：
-- 1 item1
-- 2 item2
-- 3 item3
-- 4 item4

-- 哈希表形式的表
hash_table = {key1 = "value1", key2 = "value2"}
tinsert(hash_table, "value3")  -- 新增元素会通过键值对形式插入
--不要使用 tinsert 插入到哈希表中。直接使用键值对的方式插入新值，例如：
--hash_table["key3"] = "value3"
for k, v in hash_table do
    print(k, v)
end
-- 输出：
-- key1 value1
-- 1 value3
-- key2 value2
-- n 1

注意：tinsert 只能用于操作数组形式的表（即整数索引的顺序表），而对于哈希表，不能使用 tinsert 来插入元素，而是需要直接通过键值对的方式进行赋值。

注意事项

• 索引范围：
  • tinsert 操作的索引必须在 1 到表的长度之间，否则会报错。
  • 如果插入的位置超出范围，Lua 将会抛出一个错误。
• 性能考虑：
  • 在表中间插入元素会导致其他元素移动，影响性能。处理大表时应尽量减少此类操作。
• 与数组和哈希表的区别：
  • Lua 的表既可以用于数组也可以用于哈希表（键值对）。数组是一组按顺序排列的元素，可以通过整数索引来访问；而哈希表是键值对集合，键可以是字符串或其他类型的值。tinsert 主要用于数组形式的表操作，对于哈希表则没有效果。