Functions.AAddT 方法 (__ArrayBaseT, T, UInt32)

向数组末尾添加新元素。

命名空间： XSharp.RT
程序集： XSharp.RT (在 XSharp.RT.dll 中) 版本：2.22 GA

语法

 FUNCTION AAdd<T>(
	aTarget AS ARRAY OF<T>,
	uNewElement AS T,
	nElement AS DWORD
)
 AS T

public static T AAdd<T>(
	__ArrayBase<T> aTarget,
	T uNewElement,
	uint nElement
)

查看代码

参数

aTarget: 类型：__ArrayBaseT
要添加新元素的目标数组。
uNewElement: 类型：T
分配给新元素的值。
如果 uNewElement 是另一个数组，目标数组中的新元素将包含对 uNewElement 指定的数组的引用，而不是数组本身。
nElement: 类型：UInt32
数组中要分配新值的元素位置。如果未指定 nElement，则将值分配给最后一个元素。

类型参数

T: The type of the array elements

返回值

类型：T
uNewElement 的值。

备注

AAdd() 将目标数组的实际长度增加一。
新创建的数组元素被赋予 uNewElement 指定的值。
AAdd() 用于动态增加数组的大小。
它对于构建动态列表或队列很有用。
一个很好的例子是用于保存 Get 对象的 GetList 数组。
AAdd() 类似于 ASize()，但一次只添加一个元素；ASize() 可以将数组更改为指定大小。
然而，AAdd() 的优点是可以为新元素分配值，而 ASize() 不能。
AAdd() 看似与 AIns() 相似，但它们是不同的：AIns() 在数组内移动元素，但不改变数组的长度。

示例

这些示例展示了多次调用 AAdd() 时会发生什么：

复制

1LOCAL aArray AS ARRAY
2aArray := {}                    // aArray 是一个空数组
3AAdd(aArray, 5)            // aArray 是 {5}
4AAdd(aArray, 10)            // aArray 是 {5, 10}
5AAdd(aArray, {12, 10})        // aArray 是 {5, 10, {12, 10}}
6AAdd(aArray, 1, 2 )        // aArray 是 {5, 2, 10, {12, 10}}

参见

引用