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

isEqualNodeメソッドは、Dom\Textクラスに属し、現在のテキストノードが、引数として指定された別のDOMノードと等しい内容を持つかどうかを比較し、その結果を返すメソッドです。Dom\Textクラスは、HTMLやXML文書内のテキストデータ（例えば、段落内の文字列など）を表すためのオブジェクトです。

このメソッドが判断する「等価性」とは、ノードの種類や名前、そして何よりもそのノードが保持するテキストデータの内容が、完全に一致しているかどうかを指します。具体的には、比較対象のノードが同じくテキストノードであり、かつその両方がまったく同じ文字列を保持している場合に「等しい」とみなされます。

isEqualNodeメソッドは、例えば、Webページから特定のテキストコンテンツを持つ要素を検索したり、あるテキストノードが期待する内容であるかを検証したりする際に非常に有用です。DOMツリーを操作する過程で、同じテキスト内容を持つノードが重複して存在していないかを確認する場面や、プログラムによって動的に生成されたテキストノードが、既存のノードと内容的に同じであるかを比較したい場合などに活用できます。

この比較では、ノードがコンピュータのメモリ上でまったく同じオブジェクトである必要はありません。重要なのは、それらの「内容」と「構造」が同じであるかどうかです。したがって、異なる場所で作成されたテキストノードであっても、そのテキスト内容が同一であれば、isEqualNodeメソッドは真（true）を返します。これにより、柔軟かつ正確にDOM内のテキスト情報を比較し、処理を進めることが可能になります。

Copy
1<?php
2
3$document = new DOMDocument();
4$domTextInstance = $document->createTextNode("テキストコンテンツ");
5$otherDomNodeInstance = $document->createTextNode("比較するテキスト");
6
7$areNodesEqual = $domTextInstance->isEqualNode($otherDomNodeInstance);
8
9?>

Dom\Node|null $otherNode

• Dom\Node|null $otherNode: 比較対象となる、別のDOMノードを指定します。nullを指定することも可能です。

bool

このメソッドは、指定されたノードと現在のノードが等しいかどうかを示す真偽値（trueまたはfalse）を返します。