splice (JavaScript)

配列から要素を削除して別の配列を形成します。オプションで、要素を置換することもできます。

定義場所

splice(start:int, deletecount:int, ...) : Array (Standard - JavaScript)

パラメータ	説明
`start`	開始要素。0 が最初の要素であり、0 を含みます。
`deletecount`	削除する要素の数。
`...`	置換要素のカンマ区切りのリスト。置換要素の数は、削除された要素の数と異なっていてもかまいません。

削除された要素の数が 0 で、置換要素が指定されている場合、操作は実質的に配列の先頭への挿入になります。

戻り値	説明
`Array`	削除された要素を除外し、置換要素を組み込んだ要素。

(1) 以下の計算結果ラベルでは、配列の先頭にある 2 つの要素が削除されます。

var a = new Array("one", "two", "three", "four");
a.splice(0, 2) // [three, four]

(2) 以下の計算結果ラベルでは、配列の先頭にある 2 つの要素が置換されます。

var a = new Array("one", "two", "three", "four");
a.splice(0, 2, "alpha", "beta") // [alpha, beta, three, four]

(3) 以下の計算結果ラベルでは、配列の先頭に要素が挿入されます。

var a = new Array("one", "two", "three", "four");
a.splice(0, 0, "alpha", "beta") // [alpha, beta, one, two, three, four]