函数参考

_ArrayPush

添加新值而不增加数组大小, 在结尾插入新值则删除第一个,反之亦然.

#Include <Array.au3>
_ArrayPush(ByRef $avArray, $vValue [, $iDirection = 0])

参数

$avArray 要修改的数组
$vValue 要添加的值 (可以是一个数组)
$iDirection [可选参数]原有数组元素的移动方向:
0 = 左边 (在结尾添加)
1 = 右边 (在开始添加)

返回值

成功: 返回 1
失败: 返回 0,设置@error
@error: 1 - $avArray不是一个数组
2 - $vValue是一个大于$avArray的数组(所以不适合)
3 - $avArray不是一维数组

注意/说明

该功能适合用于数据不断更新的大型数组中.类似于集合中的推动命令, 通过从不同方向减去第一个或最后一个以保留数组的所有数据(类似历史).

相关

_ArrayAdd, _ArrayConcatenate, _ArrayDelete, _ArrayInsert, _ArrayPop

示例/演示


#include <Array.au3>
;_ArrayPush(ByRef $avArray, $vValue[, $iDirection = 0])
;$avArray(需要改变的数组)
;$vValue(选择参数:0=未部 1=顶部)


Local $avArrayTarget[9] = [1, 2, 3, 4, 5, 6, 7, 8, 9]
Local $avArraySource[2] = [100, 200]

_ArrayDisplay($avArrayTarget, "运行前")

_ArrayPush($avArrayTarget, $avArraySource);改变未部数组中的所有值
_ArrayDisplay($avArrayTarget, "运行后未部改变")

_ArrayPush($avArrayTarget, $avArraySource, 1);改变顶部数组中的所有值
_ArrayDisplay($avArrayTarget, "运行后顶部改变")

_ArrayPush($avArrayTarget, "我改变了", 1);改变顶部数组中的所有值
_ArrayDisplay($avArrayTarget, "运行后顶部字符改变")