Core JavaScript 1.5 Reference:Global Objects:Array:push
出典: MDC
目次 |
[編集] 概要
配列の最後に 1 つ以上の要素を追加し、新しい配列の長さを返します。このメソッドは配列の長さを変えます。
| Array のメソッド | |
| 実装されたバージョン: | JavaScript 1.2, NES 3.0
JavaScript 1.3: |
| 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");