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

countメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月10日

基本的な使い方

countメソッドは、Dom\NamedNodeMapオブジェクトが保持する属性の数を取得するメソッドです。Dom\NamedNodeMapは、PHPのDOM拡張モジュールの一部として提供され、HTMLやXMLドキュメント内の特定の要素に付随するすべての属性（例えば、<img src="image.jpg" alt="Description">における"src"や"alt"など）の集合を管理する際に用いられます。このcountメソッドを利用することで、そのNamedNodeMapオブジェクトに格納されている属性の総数を、簡潔かつ正確に知ることができます。例えば、プログラム内でHTML要素の属性数を動的に確認したい場合や、特定の条件に基づいて属性の有無や数を判断する必要がある場合に非常に役立ちます。戻り値は常に非負の整数（int型）であり、もし対象の要素に属性が一つも存在しない場合は0が返されます。この機能は、DOMツリーを走査し、要素の構造を解析する際に頻繁に利用される基本的な操作の一つです。

構文(syntax)


1<?php
2
3$dom = new DOMDocument();
4$dom->loadXML('<element attr1="value1" attr2="value2"></element>');
5
6// Dom\NamedNodeMap クラスのインスタンスを取得します。
7$namedNodeMapInstance = $dom->documentElement->attributes;
8
9// count() 関数を使用して Dom\NamedNodeMap インスタンスに含まれるノードの数を取得します。
10$nodeCount = count($namedNodeMapInstance);

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

Dom\NamedNodeMap オブジェクトに含まれるノードの数を整数で返します。

サンプルコード

PHP DomNamedNodeMapの属性数を取得する


1<?php
2
3// DomNamedNodeMap の count メソッドのサンプルコード
4// DomNamedNodeMap は、ノードの NamedNodeMap を表します。
5// count メソッドは、マップ内のノードの数を返します。
6
7$dom = new DOMDocument();
8$dom->loadXML('<root attr1="value1" attr2="value2"></root>');
9
10$element = $dom->documentElement;
11$attributes = $element->attributes;
12
13// 属性の数を取得
14$attributeCount = $attributes->count();
15
16echo "属性の数: " . $attributeCount . PHP_EOL; // 出力: 属性の数: 2

PHPのDom\NamedNodeMapクラスのcountメソッドは、属性リスト（NamedNodeMap）に含まれる属性の数を取得するために使用します。このメソッドは引数を必要とせず、属性の数を整数値（int）で返します。

上記のサンプルコードでは、まずDOMDocumentオブジェクトを作成し、XML文字列をロードしています。次に、ルート要素を取得し、その要素の属性リスト（NamedNodeMap）を取得しています。そして、countメソッドを呼び出すことで、属性リストに含まれる属性の数を取得しています。

具体的には、<root attr1="value1" attr2="value2"></root>というXMLをロードした場合、attr1とattr2という2つの属性が存在するため、$attributes->count()は2を返します。この結果は、echo文によって「属性の数: 2」と表示されます。

このように、Dom\NamedNodeMapのcountメソッドを使うことで、要素が持つ属性の数を簡単に確認できます。XML処理において、属性の数を事前に知りたい場合などに役立ちます。

Dom\NamedNodeMap::count() は、属性ノードの数を取得する際に使用します。この関数は、引数を必要としません。返り値は整数で、属性の数を表します。DOMDocument を使用して XML を読み込み、要素の属性にアクセスする必要があります。count() を呼び出す前に、$attributes が実際に Dom\NamedNodeMap のインスタンスであることを確認してください。もし $attributes が null の場合、エラーが発生する可能性があります。属性が存在しない場合、count() は 0 を返します。