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

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

作成日: 更新日:

基本的な使い方

textContentプロパティは、Dom\XMLDocumentオブジェクトに含まれるすべてのノード、およびその子孫ノードのテキストコンテンツを、タグやコメントなどのマークアップを含まない純粋な文字列として保持するプロパティです。

このプロパティを使用することで、XMLドキュメント全体のテキストデータを一度に、かつ簡潔に抽出することが可能になります。例えば、XML文書から特定の部分の人間が読めるテキスト情報を取得したい場合や、文書の内容を一括で確認したい場合に非常に役立ちます。

textContentプロパティは読み取りだけでなく書き込みも可能です。値を設定する際には、指定された文字列がXMLドキュメントの該当する部分のテキスト内容として格納されます。この際、設定する文字列に含まれる特殊文字(例えば <& など)は自動的に適切なXMLエンティティ形式にエスケープされるため、意図しないXML構造の破損を防ぎ、安全にテキストを更新できます。

DOMツリーを深く走査して個々のテキストノードを結合する手間を省き、XML文書のテキスト表現に直接アクセスできるため、プログラムの記述を簡略化し、可読性を向上させるのに貢献します。Dom\XMLDocumentクラスにおけるtextContentプロパティは、XML文書のデータ操作において、特にテキスト内容の取得と設定を効率的に行うための重要な手段として利用されます。

構文(syntax)

1<?php
2
3$document = new Dom\XMLDocument('1.0', 'UTF-8');
4$document->loadXML('<root><child>Hello</child><child>World</child></root>');
5
6// Dom\XMLDocument オブジェクトの textContent プロパティにアクセス
7$content = $document->textContent;
8
9echo $content;
10
11?>

引数(parameters)

引数なし

引数はありません

戻り値(return)

string

Dom\XMLDocument::textContent プロパティは、ノードのすべてのテキストコンテンツを文字列として返します。

関連コンテンツ