【PHP8.x】SplFixedArray::offsetUnset()メソッドの使い方

offsetUnsetメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年01月10日

基本的な使い方

offsetUnsetメソッドは、PHPのSplFixedArrayクラスに属し、固定サイズの配列であるSplFixedArrayから指定されたオフセット（インデックス）の要素を解除するメソッドです。このメソッドは、unset($splFixedArray[$offset])という構文で配列の特定の要素をアンセットしようとした際に、内部的に呼び出されます。

SplFixedArrayは、一度初期化されるとサイズが固定されるという特性を持っています。そのため、通常のPHP配列でunset()関数を使う場合とは異なり、offsetUnsetメソッドを呼び出しても、配列から要素が完全に削除されて配列のサイズが縮小することはありません。

代わりに、指定されたオフセットに割り当てられていた値が解除され、その位置の値は多くの場合nullに設定されます。これにより、そのオフセットは「未設定」または「空」の状態として扱われます。この機能は、固定長配列の特定の要素の値をクリアしたり、データの一部をリセットしたりする目的で活用されます。

構文(syntax)


1<?php
2
3$fixedArray = new SplFixedArray(3);
4$fixedArray[0] = 'First Element';
5$fixedArray[1] = 'Second Element';
6$fixedArray[2] = 'Third Element';
7
8// 指定されたインデックスの要素を未設定にする（SplFixedArrayでは値がNULLになります）
9unset($fixedArray[1]);
10
11?>

引数(parameters)

int $index

int $index: 削除する要素のインデックスを指定する整数

戻り値(return)

戻り値なし

戻り値はありません