Visit Mozilla.org

Core JavaScript 1.5 Reference:Global Objects:Array:push

出典: MDC


目次

[編集] 概要

配列の最後に 1 つ以上の要素を追加し、新しい配列の長さを返します。このメソッドは配列の長さを変えます。

Array のメソッド
実装されたバージョン: JavaScript 1.2, NES 3.0

JavaScript 1.3: push は配列に追加した最後の要素ではなく、新しい配列の長さを返します。

ECMA バージョン: ECMA-262 Edition 3

[編集] 構文

var newlen = array.push(element1, ..., elementN);

[編集] 引数

element1, ..., elementN 
配列の末尾に追加する要素。

[編集] 説明

push メソッドの振る舞いは Perl 4 の push 関数と似ています。この振る舞いは Perl 5 とは異なることに注意してください。

[編集] 後方互換性

[編集] JavaScript 1.2

push メソッドは配列に追加した最後の要素を返します。

[編集]

[編集] 例: 配列に要素を追加する

以下のコードは 2 つの要素を持つ配列 myFish を生成し、それに 2 つの要素を追加します。コードの実行後、pushed には 4 が入ります。(JavaScript 1.2 では、コードの実行後 pushed には "lion" が入ります。)

var myFish = ["angel", "clown"];
var pushed = myFish.push("drum", "lion");

[編集] 参照

pop, shift, unshift