→
その Array 内の、指定位置から指定数の要素を削除し、指定の新しい要素を追加をし、削除した要素を配列で返します。元の Array は更新されます。→。
| array | Arrayオブジェクト |
|---|---|
| start | 配列を変更する開始位置を表すインデックスです。
値が配列の長さより大きい場合は、start は配列の長さに設定されます。この場合、削除される要素はありませんが、このメソッドは追加関数として動作し、提供された item[n*] の数だけ要素を追加します。 値が負数の場合は、配列の末尾から要素数を戻ったところから始まります（-1 が原点で、-n は最後の要素から n 番目であることを意味し、したがってインデックスが array.length - n であるのと同等です）。 start の絶対値が配列の長さよりも大きい場合は、インデックス 0 から始まります。 |
| deleteCount | 配列の start から取り除く古い要素の数を示す整数です。
deleteCount 引数が省略された場合、または array.length - start 以上 (つまり、start から始まり、配列に残る要素の数以上の場合) の場合、start 以降のすべての要素が取り除かれます。 メモ： IE8 では、deleteCount が省略された場合はすべての要素を削除しません。 deleteCount が 0 か負数の場合、どの要素も取り除かれません。この場合、少なくとも 1 つの新しい要素を指定する必要があります。 |
| itemｎ | 配列に追加する要素で、start から始まります。要素を指定しなかった場合、splice() は単に配列から要素を取り除きます。 |
戻り値： 取り除かれた要素を含む配列です。
要素が 1 つのみ削除された場合は、要素数 1 の配列が返されます。
要素が削除されなかった場合、空の配列が返されます。
取り除こうとする要素数と異なる数の要素を挿入するように指定した場合、関数呼び出しが終わったとき配列は初めと異なる長さになります。
A=['angel', 'clown', 'mandarin', 'sturgeon']; D=A.splice(2, 0, 'drum'); //＝[]。A＝["angel", "clown", "drum", "mandarin", "sturgeon"]
|
|