Futurebasic/语言/参考/def dynamicinsertitems
✔ 外观 ✔ 标准 ✔ 控制台
DEF DYNAMICINSERTITEMS(gMyDynamicArray, Where&, HowMany&, FillPtr&)
2006 年 11 月 (FB 4, 版本 4)
此函数将 gMyDynamicArray 中的项目 Where& 及其后续项目向后移动 HowMany& 个位置，从而在位置 Where& 开始处留下 HowMany& 个新项目。数组中的项目总数增加 HowMany& 个（或更多，见下文），插入的项目（从 Where& 开始）将填充来自 FillPtr& 的数据，或者如果 FillPtr& 为 0，则填充零。
无论当前是否已填充，动态数组必须在传递给此函数之前，在某个时刻包含数据。
gMyDynamicArray 是使用 DYNAMIC 或 DIMÊDYNAMIC 以前定义的任何 FutureBASIC 动态数组。
Where& 是将插入第一个项目的数组位置。它必须 >= 0。 Where& 通常小于数组中当前的项目数量，但可以大于。如果它大于，将插入足够的空项目，以提供从项目 Where& 开始的 HowMany& 个项目。例如，如果您的数组中有 10 个项目（0-9），并在项目 #13 处插入 2 个项目，您的数组将包含原始的 10 个项目，然后是 3 个空项目（10-12），以及 2 个插入的项目（13-14），总共 15 个项目。
HowMany& 指定要插入的项目数量。它也表示数组中任何更高特定项目的索引将增加的数量。
FillPtr& 是一个地址，其中新的数据正在等待插入到 gMyDynamicArray 中。这些必须与 gMyDynamicArray 具有相同的格式，以及相同大小的元素。在 OS 9 中，如果将取消引用的句柄作为 FillPtr& 传递，则应先锁定句柄。 DEF DYNAMICINSERTITEMS 不检查以确保有足够的数据要复制。
DEF DYNAMICREMOVEITEMS; DYNAMIC; USR DYNAMICITEMSIZE