array_splice

配列の一部を削除し、他の要素に置き換える
削除はせずに、任意の箇所に配列を追加する

使い方

書き方

array_splice(第一引数, 第二引数, 第三引数, 第四引数);

第一引数
対象の配列
第二引数
要素の抽出開始位置
負の値の場合は、配列の末尾を-1として数えた位置になる
第三引数
取り出す要素数
第四引数
削除された要素が、この配列の要素で置換される

例

$color = ['赤色', '青色', '黄色', '緑色', '紫色'];
var_dump(array_splice($color, 2, 3, ['白色', '黒色', 'ピンク色']));
//Array ( [0] => 黄色 [1] => 緑色 [2] => 紫色 ) 
var_dump($color);
//Array ( [0] => 赤色 [1] => 青色 [2] => 白色 [3] => 黒色 [4] => ピンク色 )

第一引数
配列の「$color」
第二引数
削除の開始位置は「2」
第三引数
取り出す要素数は「3」
第四引数
削除した要素を「白色, 黒色, ピンク色」に置き換える

※ 2行目のように array_splice は置き換えた後の配列が返ってくるのではなく、削除した配列が返ってくる

削除せずに追加する

$color = ['赤色', '青色', '黄色', '緑色'];
var_dump(array_splice($color, 2,0,['白色', '黒色', 'ピンク色']));
//Array ( ) 
var_dump($color);
//Array ( [0] => 赤色 [1] => 青色 [2] => 白色 [3] => 黒色 [4] => ピンク色 [5] => 黄色 [6] => 緑色 )

2番目の要素から0個の要素を削除して、「白色, 黒色, ピンク色」に置き換えることになる。
なので、削除することなく任意の場所に配列を追加することができる。