public unshift(value:Object) : Number

1 つまたは複数のエレメントを配列の先頭に追加して、配列の新しい長さを返します。

パラメータ

value:Object - 配列の先頭に挿入される数値、エレメント、または変数。

戻り値

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

例

次の例では、Array.unshift() メソッドの使用法を示します。

var pets_array:Array = new Array("dog", "cat", "fish");
trace( pets_array ); // dog,cat,fish を表示します。
pets_array.unshift("ferrets", "gophers", "engineers");
trace( pets_array ); // ferrets,gophers,engineers,dog,cat,fish を表示します。

関連項目

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