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

hasChildNodesメソッドは、DOMEntityReferenceオブジェクトが子ノードを持っているかどうかを確認するメソッドです。このメソッドを呼び出すと、対象となるエンティティ参照ノードの直下に、要素ノード、テキストノード、コメントノードなど、何らかの種類の子ノードが一つでも存在するかどうかを判定します。戻り値は真偽値（boolean）であり、子ノードが存在する場合にはtrueを、存在しない場合にはfalseを返します。この機能は、DOMドキュメントの構造を解析する際に特に役立ちます。例えば、特定のエンティティ参照ノードを処理する際に、そのノードが子を持っているかどうかを事前に確認し、子が存在する場合にのみ再帰的な処理を行うといった条件分岐を実装するために利用できます。このメソッドは引数を必要とせず、単に対象オブジェクトの状態を問い合わせるために使用されます。

Copy
1<?php
2
3$xml = <<<XML
4<?xml version="1.0" encoding="utf-8"?>
5<!DOCTYPE root [
6<!ENTITY exampleEntity "Entity Text">
7]>
8<root>&exampleEntity;</root>
9XML;
10
11$doc = new DOMDocument();
12$doc->loadXML($xml);
13
14// <root>要素の子ノードであるエンティティ参照ノードを取得します
15$entityRefNode = $doc->documentElement->firstChild;
16
17// DOMEntityReferenceノードが子ノードを持っているかを確認します
18// この場合、"Entity Text"というテキストノードを持つため、trueが返ります
19if ($entityRefNode->hasChildNodes()) {
20    // bool(true) が出力されます
21    var_dump(true);
22} else {
23    // bool(false) が出力されます
24    var_dump(false);
25}
26
27?>

引数なし

引数はありません

bool

DOMEntityReference オブジェクトが子ノードを持っているかどうかを示します。子ノードがあれば true を、なければ false を返します。