末尾に新しい値を挿入し、1番目の要素を削除、または逆をおこなうことで配列サイズを増やさずに値を追加します。
#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は1次元配列ではありません |
注意
この関数は、この関数を使用しない場合、巨大なサイズの配列を作成しなければならないような配列内のデータを継続して更新する処理で使用されます。
関連
_ArrayAdd, _ArrayConcatenate, _ArrayDelete, _ArrayInsert, _ArrayPop
例
#include <Array.au3>
Local $avArrayTarget[9] = [1, 2, 3, 4, 5, 6, 7, 8, 9]
Local $avArraySource[2] = [100, 200]
_ArrayDisplay($avArrayTarget, "$avArrayTarget BEFORE _ArrayPush()")
_ArrayPush($avArrayTarget, $avArraySource)
_ArrayDisplay($avArrayTarget, "$avArrayTarget AFTER _ArrayPush() array to end")
_ArrayPush($avArrayTarget, $avArraySource, 1)
_ArrayDisplay($avArrayTarget, "$avArrayTarget AFTER _ArrayPush() array to beginning")
_ArrayPush($avArrayTarget, "Hello world!", 1)
_ArrayDisplay($avArrayTarget, "$avArrayTarget AFTER _ArrayPush() string to beginning")