【PHP8.x】childElementCountプロパティの使い方

childElementCountプロパティは、Dom\XMLDocumentクラスが表すXMLドキュメントの直下にある子要素の数を保持するプロパティです。

このプロパティは、DOM (Document Object Model) の考え方に基づき、ドキュメントノードに直接含まれる全ての子ノードの中から、要素ノード（Element型）に該当するものだけを数え上げてその合計値を整数で返します。したがって、テキストノード、コメントノード、処理命令ノード、DOCTYPEノードといった他の種類のノードはカウントの対象外となります。

システムエンジニアを目指す初心者の方々にとって、XMLドキュメントの構造をプログラムで解析したり操作したりする際に、特定の階層にいくつの要素が存在するかを知ることは非常に重要です。例えば、XMLドキュメントのルート要素が一つだけ存在するかを確認したい場合などに、このプロパティを参照することで容易に判断できます。整形式のXMLドキュメントでは、通常、ドキュメントノードの直下には単一のルート要素のみが存在するため、このプロパティの値は一般的に1を返します。このプロパティを利用することで、XMLドキュメントの構造的な健全性を確認したり、特定の処理を行う前に要素の存在数をチェックしたりする場面で役立ちます。

Copy
1<?php
2
3$document = new Dom\XMLDocument();
4$document->loadXML('<data><item id="1"/><item id="2"/></data>');
5
6echo $document->childElementCount;
7
8?>

引数なし

引数はありません

int

このプロパティは、対象となるXML要素の直下にある子要素の数を整数で返します。