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

offsetGetメソッドはSplDoublyLinkedListオブジェクト内の指定されたインデックスにある要素を取得するために使用されるメソッドです。SplDoublyLinkedListクラスは、双方向連結リストというデータ構造を実装しており、要素を効率的に追加したり削除したりできます。offsetGetメソッドは、このリストに格納されている特定の要素にアクセスする際に利用されます。

このメソッドを使うことで、まるで配列のように、リスト内の要素をインデックス（添字）を指定して読み出すことができます。インデックスは通常、リストの先頭から0、1、2…と割り当てられます。例えば、offsetGet(0)はリストの最初の要素を、offsetGet(1)は2番目の要素を返します。

また、負のインデックスもサポートしており、offsetGet(-1)はリストの最後の要素を、offsetGet(-2)は最後から2番目の要素を指します。これは、リストの末尾から要素にアクセスしたい場合に便利です。

指定されたインデックスがリストの有効な範囲外である場合、つまり存在しない位置の要素にアクセスしようとすると、OutOfRangeExceptionというエラーが発生します。これは、プログラムが不正なアクセスを試みたことを示し、問題を発見するのに役立ちます。このメソッドは、リスト内のデータが必要な位置にあるかを確認したり、その値を利用して他の処理を行ったりする際に非常に重要です。

Copy
1<?php
2
3$list = new SplDoublyLinkedList();
4$list->push('first element');
5$list->push('second element');
6$list->push('third element');
7
8$value = $list[1];
9
10?>

int $index

• int $index: 取得したい要素のインデックス（位置）を指定する整数

mixed

SplDoublyLinkedList の offsetGet メソッドは、指定したオフセット（位置）にある要素の値を返します。