【PHP8.x】Dom\ProcessingInstruction::DOCUMENT_POSITION_DISCONNECTED定数の使い方

『DOCUMENT_POSITION_DISCONNECTED定数は、2つのノードが同じDOMツリーに属しておらず、互いに接続されていない状態であることを示す定数です。この定数は、主に Dom\Node::compareDocumentPosition() メソッドの戻り値として利用されます。compareDocumentPosition() メソッドは、あるノードを基準として、引数で渡された別のノードが文書内のどの位置にあるかを比較し、その関係性を数値で返します。この戻り値はビットマスクであり、複数の状態が組み合わさって表現される場合があります。返された数値に DOCUMENT_POSITION_DISCONNECTED が示すビットが含まれている場合、それは比較対象の2つのノードが異なるドキュメントに属しているか、またはドキュメントツリーにまだ追加されていない孤立した状態であることを意味します。したがって、2つのノードの前後関係や親子関係を調べる前に、そもそも両者が同じ文書コンテキスト内に存在するかどうかを確認するための重要な指標となります。

Copy
1<?php
2
3echo Dom\ProcessingInstruction::DOCUMENT_POSITION_DISCONNECTED;

引数なし

引数はありません

int

Dom\ProcessingInstruction::DOCUMENT_POSITION_DISCONNECTED は、ノードが別のドキュメントに属していることを示す整数値を返します。