[関数の使い方･書式]

○ ＝ push ☆,★

☆：(スカラー値) 配列変数。
★：(リスト) 追加する値のリスト。
○：(スカラー値) 追加後の総要素数(配列の長さ)。

---

[関数の機能]

リスト値★を配列変数☆の末尾に追加します。 追加された配列☆の長さ(要素数)は追加した要素分増加します。
配列をスタックのように使用できるようにしたもので、この機能は

for $add ( @second_arg ) {
    $array[++$#array] = $add;
}

と等価ですが、push 関数の方が効率的です。

---

[書式の例]

$return = push @array, @list;

配列 @array の末尾に配列 @list を追加します。

● 大文字に変換する
for (@list) {
	push @caps, uc($_);
}

● 大量の連番を取る処理の結果を収集する(..演算子より効率的)
for ($i=5; $i<100_000; $i++) {
	push(@results, &func($i));
}

● ２つの配列で重複している要素を取り出す
foreach $element (@aray1, @array2) { $union{$element}++; }
foreach $key (keys %union) {
	if ( $union{$key} > 1 ) { push @same, $key; }
}

● 先頭の要素を末尾に移動する
push (@array, shift(@array));