array.splice( index, deleteCount, element1, …, elementN )メソッドは、配列から要素を取り除いたり、配列に要素を追加したりし、取り除いた要素を返すメソッド。
構文
array.splice( index, deleteCount, element1, …, elementN )
引数
- index
- 取り除き、もしくは、追加を開始するインデックスを指定する。
- deleteCount
- 取り除く要素数を指定する。
- 取り除かない場合は、「0」を指定する。
- element1, …, elementN
- 追加したい要素を指定する。
- カンマで区切り、複数指定できる。
- 要素を追加しない場合は、省略すればよい。詳しくは、array.splice( index, deleteCount )へ
戻り値
配列から取り除いた要素。
サンプル
追加
<script type="text/javascript">
var $sampleArray = new Array( '要素１', '要素２', '要素３', '要素４', '要素５' );
var $sampleArraySplice = $sampleArray.splice( 1, 0, '追加１', '追加２' );
document.write( '$sampleArraySplice: ' + $sampleArraySplice + '<br />' );
document.write( '$sampleArray: ' + $sampleArray + '<br />' );
</script>
var $sampleArray = new Array( '要素１', '要素２', '要素３', '要素４', '要素５' );
var $sampleArraySplice = $sampleArray.splice( 1, 0, '追加１', '追加２' );
document.write( '$sampleArraySplice: ' + $sampleArraySplice + '<br />' );
document.write( '$sampleArray: ' + $sampleArray + '<br />' );
</script>
↓↓↓出力結果↓↓↓
変更
<script type="text/javascript">
var $sampleArray = new Array( '要素１', '要素２', '要素３', '要素４', '要素５' );
var $sampleArraySplice = $sampleArray.splice( 1, 2, '変更１', '変更２' );
document.write( '$sampleArraySplice: ' + $sampleArraySplice + '<br />' );
document.write( '$sampleArray: ' + $sampleArray + '<br />' );
</script>
var $sampleArray = new Array( '要素１', '要素２', '要素３', '要素４', '要素５' );
var $sampleArraySplice = $sampleArray.splice( 1, 2, '変更１', '変更２' );
document.write( '$sampleArraySplice: ' + $sampleArraySplice + '<br />' );
document.write( '$sampleArray: ' + $sampleArray + '<br />' );
</script>
↓↓↓出力結果↓↓↓
変更及び追加
<script type="text/javascript">
var $sampleArray = new Array( '要素１', '要素２', '要素３', '要素４', '要素５' );
var $sampleArraySplice = $sampleArray.splice( 1, 1, '変更１', '追加１' );
document.write( '$sampleArraySplice: ' + $sampleArraySplice + '<br />' );
document.write( '$sampleArray: ' + $sampleArray + '<br />' );
</script>
var $sampleArray = new Array( '要素１', '要素２', '要素３', '要素４', '要素５' );
var $sampleArraySplice = $sampleArray.splice( 1, 1, '変更１', '追加１' );
document.write( '$sampleArraySplice: ' + $sampleArraySplice + '<br />' );
document.write( '$sampleArray: ' + $sampleArray + '<br />' );
</script>
↓↓↓出力結果↓↓↓