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

childElementCountプロパティは、Dom\Elementクラスに属し、指定された要素の直下にある子要素の数を保持するプロパティです。このプロパティを使用することで、HTMLやXML文書内で特定の要素が直接いくつの子要素（タグ）を持っているかを簡単に調べることができます。

ここで言う「子要素」とは、XMLやHTMLのタグで表現される要素ノードのみを指します。テキストノード（要素内の文字コンテンツ）やコメントノード、処理命令ノードなどは含まれません。例えば、<p>Hello <b>World</b>!</p>という要素の場合、childElementCountは<b>要素のみを数えるため、「1」を返します。もし<p>Hello World!</p>のように子要素がない場合は「0」を返します。

このプロパティが返す値は常に非負の整数（int型）です。また、childElementCountは読み取り専用のプロパティであり、その値を直接変更することはできません。文書構造を解析する際や、特定の子要素の存在確認、あるいは繰り返しの処理を行う前の要素数の取得などに非常に役立ちます。

PHPのDOM拡張機能を使用してWebページの構造を操作したり、XMLデータを処理したりする際に、子の要素ノードだけを効率的に数えたい場合に、このchildElementCountプロパティは非常に有用なツールとなります。

Copy
1<?php
2$dom = new DOMDocument();
3$parentElement = $dom->createElement('parent');
4$dom->appendChild($parentElement);
5
6$childElement1 = $dom->createElement('child1');
7$parentElement->appendChild($childElement1);
8
9$childElement2 = $dom->createElement('child2');
10$parentElement->appendChild($childElement2);
11
12$textNode = $dom->createTextNode('This is a text node.');
13$parentElement->appendChild($textNode);
14
15// Dom\Element の子要素（要素ノードのみ）の数を取得します。
16$childCount = $parentElement->childElementCount;
17
18echo "子要素の数: " . $childCount; // 出力例: 子要素の数: 2
19?>

引数なし

引数はありません

int

このプロパティは、要素の直接の子要素の数を整数で返します。