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