Functions.AIns 方法 (__Array, UInt32) | |
在数组中插入一个元素并将其赋值为 NIL。
命名空间:
XSharp.RT
程序集:
XSharp.RT (在 XSharp.RT.dll 中) 版本:2.22 GA
语法 FUNCTION AIns(
aTarget AS ARRAY,
dwPosition AS DWORD
) AS ARRAY
public static __Array AIns(
__Array aTarget,
uint dwPosition
)
查看代码参数
- aTarget
- 类型:__Array
要插入元素的数组。 - dwPosition
- 类型:UInt32
要插入元素的位置。
返回值
类型:
__Array
对
aTarget 的引用。
备注
AIns() 在指定数组中插入一个新元素。
新插入的元素为 NIL,直到为其赋予新值。
插入后,数组中的最后一个元素被丢弃,新元素之后的所有元素向下移动一个位置。
在多维数组中使用 AIns() 时必须小心。
在多维数组中使用 AIns() 会丢弃指定目标数组中的最后一个元素,如果它是一个数组元素,将导致一个或多个维度丢失。
要在数组中插入新维度,请先使用 AAdd() 或 ASize() 在数组末尾添加新元素,然后再使用 AIns()。
示例
此示例演示了在数组上使用 AIns() 的效果:
1LOCAL aArray AS ARRAY
2aArray := {1, 2, 3}
3AIns(aArray, 2)
参见