アレイ・スプライス
array_spliceの読み方
array_spliceは「アレイ・スプライス」と読みます。PHPで、配列の指定した位置から要素を削除し、必要に応じて別の要素を挿入・置換する関数です。元の配列を変更し、削除した要素を配列として返します。
array_spliceの読み方と意味
英単語arrayの発音は /əˈreɪ/、spliceは /splaɪs/ で、カタカナはその目安です。arrayは配列、spliceは端をつなぎ合わせる意味を持ちます。PHP公式マニュアルでは、配列の一部を削除して他の要素で置換する関数として説明されています。
基本例:指定位置から末尾まで削除する
位置は0から数えます。次の array_splice($arr, 2) は、位置2の「c」から末尾までを削除します。「2番目までを削除」する動作ではありません。第3引数の削除数を省略すると末尾までが対象です。
<?php
$arr = array("a", "b", "c", "d", "e");
$result = array_splice($arr, 2); // 位置2(3番目の要素)から末尾までを削除
var_dump($result);
実行結果

この例の戻り値$resultには「c」「d」「e」が入り、元の$arrには「a」「b」が残ります。戻り値は編集後の配列ではなく、削除された要素の配列です。編集結果を確認する場合は$arrを参照します。
指定した個数の削除・置換・挿入
第3引数は削除する要素数、第4引数は差し込む要素です。削除数を0にすると、元の要素を削除せず指定位置へ挿入できます。たとえば一覧の途中の項目を入れ替える場面で使います。
<?php
$arr = array("a", "b", "c");
$removed = array_splice($arr, 1, 1, array("x", "y"));
// $arr は array("a", "x", "y", "c")
// $removed は array("b")
$arr = array("a", "b", "c");
array_splice($arr, 1, 0, array("x"));
// $arr は array("a", "x", "b", "c")
array_sliceとの違い
array_spliceは元の配列を編集し、array_sliceは指定範囲を取り出すために使います。元の配列を残したまま一部を取得したい場合はarray_sliceが適しています。同じoffsetやlengthでも、元配列への影響が異なる点に注意してください。
位置とキーの注意点
offsetが負数なら末尾から数えます。たとえば array_splice($arr, -1) は最後の要素を削除します。また、array_spliceでは数値キーが振り直され、挿入用配列のキーも保持されません。キーの維持が必要な処理では、この仕様を確認してから使用してください。
参考リンク
PHP公式:array_splice
PHP公式:array_slice
Collins:arrayの意味・発音
Collins:spliceの意味・発音
-
前の記事
SHA-3の読み方 2020.08.12
-
次の記事
array_sliceの読み方 2020.08.12