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

isEqualNodeメソッドは、現在のDOMAttrオブジェクトと、引数として渡された別のDOMノードが構造的に等しいかどうかを比較し、その結果を真偽値で返すメソッドです。

このメソッドは、2つのノードが同じノード型、ノード名、ノード値、名前空間URI、およびプレフィックスを持っているかを確認します。DOMAttrオブジェクトの文脈では、主に属性の名前と値が比較の対象となります。例えば、class="my-class"という属性と、別のclass="my-class"という属性が比較された場合、それらが異なるオブジェクトインスタンスであっても、内容が同一であれば等しいと判断されます。

isEqualNodeメソッドは、オブジェクトがメモリ上で同一であるか（厳密な同一性）を検査するのではなく、その構造と内容が論理的に同一であるかを検査します。

この機能は、HTMLやXML文書を扱う際に、特定の属性が特定の条件を満たすかを確認したり、異なるDOMツリー内の属性同士を比較して同一性を判定したりする場面で非常に有用です。例えば、ユーザー入力によって変更された属性が元の値と異なっているかを確認する、あるいは、テンプレート内の属性が期待通りのものであるかを検証するといった用途に活用できます。

完全に一致する場合にtrueを返し、一つでも異なる点があればfalseを返します。

Copy
1<?php
2$document = new DOMDocument();
3
4// 1つ目のDOMAttrオブジェクトを作成
5$elementA = $document->createElement('tag');
6$attrA = $document->createAttribute('id');
7$attrA->value = 'unique_id_1';
8$elementA->appendChild($attrA);
9
10// 2つ目のDOMAttrオブジェクトを作成
11$elementB = $document->createElement('tag');
12$attrB = $document->createAttribute('id');
13$attrB->value = 'unique_id_1';
14$elementB->appendChild($attrB);
15
16// DOMAttr::isEqualNode メソッドの構文
17// 2つのDOMNodeオブジェクトが等しいかどうかを比較し、真偽値を返します。
18$areNodesEqual = $attrA->isEqualNode($attrB);
19?>

DOMNode $otherNode

• DOMNode $otherNode: 比較対象となる他のDOMNodeオブジェクト

bool

このメソッドは、比較対象の DOMAttr オブジェクトが、この DOMAttr オブジェクトと等しい場合に true を返します。等しくない場合は false を返します。