Functions.Hb_AIns 方法

在数组的特定位置插入一个值，并且可以增加数组的长度。

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

语法

 FUNCTION Hb_AIns(
	aArray,
	nPos,
	xValue,
	lAutoSize
) AS ARRAY CLIPPER

[ClipperCallingConventionAttribute(new string[] { ... })]
public static __Array Hb_AIns(
	__Usual aArray = default,
	__Usual nPos = default,
	__Usual xValue = default,
	__Usual lAutoSize = default
)

查看代码

参数

aArray (Optional): 类型：__Usual
要插入元素的数组的名称。
nPos (Optional): 类型：__Usual
要插入元素的下标。默认值：1。
xValue (Optional): 类型：__Usual
要插入的值
lAutoSize (Optional): 类型：__Usual
布尔标志，指定是否调整数组的大小。默认值：.F.（不调整大小）。

返回值

类型：__Array
更改后的数组

备注

此函数将 xValue 插入数组的 nPos 位置，将数组列表中的所有项向下移动一个位置。
如果lAutoSize为.T.，那么一个新元素将被添加到数组的末尾，腾出空间来容纳之前的最后一个元素，这意味着数组的长度将增加1。
如果lAutoSize为.F.（或未传递），函数的行为类似于AIns()，即aArray的大小不会改变，并且aArray的最后一个项将被丢失。

示例

复制

1LOCAL aArray := {1,3,4}
2hb_AIns( aArray, 2 ,2)
3? Alen(aArray) // 3
4? aTail(aArray) // 3
5aArray := {1,3,4}
6hb_AIns( aArray, 2 , 2, .T.)
7? Alen(aArray) // 4
8? ATail(aArray) // 4

参见

引用

Functions 类

XSharp.Harbour 命名空间

AIns

Hb_ADel(__Usual, __Usual, __Usual)