【PHP8.x】nodeValueプロパティの使い方
nodeValueプロパティの使い方について、初心者にもわかりやすく解説します。
作成日: 更新日:
基本的な使い方
nodeValueプロパティは、Dom\CDATASectionオブジェクトが表現するCDATAセクションの文字データ(テキストコンテンツ)を保持するプロパティです。Dom\CDATASectionクラスは、XMLやHTMLドキュメント内で、特殊なマークアップとして解釈されず、そのままの文字データとして扱われるべきコンテンツのブロックであるCDATAセクションを表します。このプロパティを使用すると、CDATAセクション内に含まれる具体的なテキストコンテンツにアクセスしたり、その値を変更したりすることが可能です。
例えば、XMLドキュメントからCDATAセクションを読み込む際、そのセクションの中にある実際の文字列データはnodeValueプロパティを通じて取得できます。逆に、新しいCDATAセクションを作成したり、既存のCDATAセクションの内容を更新したりする場合も、このプロパティに値を設定することで、目的のテキストコンテンツを埋め込むことができます。このように、nodeValueプロパティは、XMLやHTMLドキュメントの特定のテキスト部分、特にCDATAセクションの内容をプログラム的に操作するための、シンプルかつ直接的な手段を提供します。
構文(syntax)
1<?php 2 3$doc = new DOMDocument(); 4$cdata = $doc->createCDATASection('CDATA Section Content'); 5 6// Dom\CDATASection の nodeValue プロパティから値を取得する構文 7$content = $cdata->nodeValue; 8echo $content; // 出力: CDATA Section Content 9 10// Dom\CDATASection の nodeValue プロパティに値を設定する構文 11$cdata->nodeValue = 'New CDATA Content'; 12echo $cdata->nodeValue; // 出力: New CDATA Content 13 14?>
引数(parameters)
引数なし
引数はありません
戻り値(return)
string|null
Dom\CDATASection::nodeValue は、CDATA セクションのテキスト内容を文字列で返します。CDATA セクションが空の場合や、ノードが有効でない場合は null を返します。