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

lengthプロパティの使い方について、初心者にもわかりやすく解説します。

作成日: 更新日:

基本的な使い方

lengthプロパティは、Dom\DtdNamedNodeMapクラスのインスタンスが保持するノードの数を保持するプロパティです。Dom\DtdNamedNodeMapは、XMLやHTMLなどのドキュメントにおけるドキュメントタイプ定義(DTD)に関連する名前付きのノード集合を表します。具体的には、要素の属性リスト定義やエンティティ定義など、DTD内で定義される複数の項目を管理する際に使用されます。このlengthプロパティを参照することで、Dom\DtdNamedNodeMapオブジェクトが現在保持している定義の総数を簡単に取得することが可能です。例えば、DTD内でいくつの属性リスト定義がされているかを確認したい場合や、集合が空であるかどうかを判定したい場合などに、このプロパティが役立ちます。lengthプロパティの値は常に非負の整数であり、その時点での集合のサイズを正確に示します。DOM拡張機能を用いてDTD関連の情報を操作する際に、集合の大きさを知るための基本的な手段として利用されます。

構文(syntax)

1<?php
2$xmlString = <<<XML
3<!DOCTYPE root [
4  <!ENTITY example1 "value1">
5  <!ENTITY example2 "value2">
6]>
7<root/>
8XML;
9
10$dom = new DOMDocument();
11$dom->loadXML($xmlString);
12
13$doctype = $dom->doctype;
14
15if ($doctype instanceof DOMDocumentType) {
16    $dtdNamedNodeMap = $doctype->entities;
17    echo $dtdNamedNodeMap->length;
18}

引数(parameters)

引数なし

引数はありません

戻り値(return)

int

このプロパティは、Dom\DtdNamedNodeMap オブジェクトに含まれるノードの数を整数で返します。

【PHP8.x】lengthプロパティの使い方 | いっしー@Webエンジニア