【PHP8.x】XMLReader::hasValueプロパティの使い方

hasValueプロパティは、PHPのXMLReaderクラスにおいて、XMLドキュメントの現在位置にあるノードが何らかの「値」を持っているかどうかを示す真偽値（bool）を保持するプロパティです。このプロパティは読み取り専用であり、XMLReaderオブジェクトがread()メソッドでXMLドキュメントを読み進め、現在のノードにフォーカスがあるときに参照可能です。

具体的には、hasValueがtrueを返す場合、現在のノードはテキストコンテンツ、属性値、CDATAセクションの内容、処理命令のデータ、コメントの内容といった形式で値を持ちます。例えば、<element attr="value">テキストデータ</element>というXMLの一部があったとします。この場合、attr属性のノードやテキストデータのノードに対してはhasValueプロパティがtrueを返し、その具体的な値はXMLReader::valueプロパティから取得できます。

一方で、要素ノード（例：<element>や</element>など）やドキュメントノードといった、直接的なテキストコンテンツを持たないノードに対しては、hasValueプロパティはfalseを返します。

このプロパティを利用することで、システムはXML構造を解析する際に、現在のノードが処理すべき有効なテキスト情報やデータを含んでいるかを効率的に判断し、適切な処理の分岐を行うことができます。特に、XMLReader::valueプロパティと組み合わせて使用することで、値を持つノードからその具体的なコンテンツを安全かつ効率的に取得するロジックを実装する上で非常に役立ちます。

Copy
1<?php
2$xml = '<item_data><name>Example Product</name><price>100</price></item_data>';
3$reader = new XMLReader();
4$reader->XML($xml);
5
6while ($reader->read()) {
7    // 現在のノードがテキスト値を持つかどうかを確認する構文
8    if ($reader->hasValue) {
9        // 値を持つノードの場合、その値を取得する構文
10        echo "Value: " . $reader->value . "\n";
11    }
12}
13$reader->close();
14?>

引数なし

引数はありません

bool

現在処理中のノードが値を持っている場合に true を、そうでない場合に false を返します。