push (Array.push メソッド)

public push(value: Object) : Number

エレメントを配列の最後に追加して、配列の新しい長さを返します。

使用できるバージョン : ActionScript 1.0、Flash Lite 2.0

パラメータ

value: Object - 配列に付加される値。

戻り値

Number - 新しい配列の長さを表す整数。

次の例では、cat と dog の 2 つのエレメントを持つ配列 myPets_array を作成します。2 行目で配列に 2 つのエレメントを追加します。

push() メソッドから配列の新しい長さが返されるので、最終行の trace() ステートメントは myPets_array の新しい長さ (4) を [出力] パネルに表示します。

var myPets_array: Array = new Array("cat", "dog");
var pushed: Number = myPets_array.push("bird", "fish");
trace(pushed); // 4 を表示する

関連項目

pop (Array.pop メソッド), shift (Array.shift メソッド), unshift (Array.unshift メソッド)