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