【PHP8.x】itemメソッドの使い方

itemメソッドは、Dom\HTMLCollectionオブジェクト内の指定されたインデックスに対応するノードを返すメソッドです。Dom\HTMLCollectionは、HTMLドキュメント内の要素のコレクション（例えば、同じタグ名を持つ要素のリスト）を表します。このメソッドを使用することで、コレクション内の特定の要素にアクセスできます。

具体的には、item(int $index): ?DOMNodeという形式で定義されており、整数型の引数 $index を受け取ります。この $index は、コレクション内の要素の位置を示す0から始まるインデックスです。

メソッドの戻り値は、DOMNode型、またはnullです。DOMNodeは、DOM（Document Object Model）におけるノードを表す一般的なクラスで、要素、テキスト、属性など、ドキュメント内のあらゆる構成要素の基底クラスとなります。指定された $index がコレクションの範囲内の場合、itemメソッドはそのインデックスに対応するDOMNodeオブジェクトを返します。

もし $index がコレクションの範囲外（例えば、コレクションのサイズよりも大きい場合や負の値の場合）である場合、itemメソッドはnullを返します。これは、指定されたインデックスに対応する要素が存在しないことを意味します。

このメソッドは、Dom\HTMLCollection内の要素を順番に処理したり、特定の条件に基づいて要素を選択したりする際に非常に役立ちます。例えば、特定のタグ名の要素が複数存在する場合に、itemメソッドを使用して各要素に個別にアクセスし、その属性や内容を調べることができます。foreachループなどと組み合わせて使うことで、コレクション内のすべての要素に対して処理を行うことも容易になります。

Copy
1public Dom\Node? Dom\HTMLCollection::item(int $index)

int $index

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

?Dom\Element

引数として指定されたインデックス番号に対応する Dom\Element オブジェクト、または要素が存在しない場合は null を返します。