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

substringDataメソッドは、Dom\CDATASectionクラスに属し、XMLやHTML文書内で特殊文字をエスケープせずに記述するための要素であるCDATAセクションノードが保持する文字データの一部を抽出するメソッドです。

このメソッドは、CDATAセクションの内容から、指定された開始位置（オフセット）から特定の長さの文字データだけを取得するために利用されます。第一引数 $offset には、文字データの先頭を0として、抽出を開始する位置を整数で指定します。第二引数 $count には、$offsetで指定された位置から何文字を抽出するかを整数で指定します。

メソッドの実行結果として、指定された範囲に対応する部分文字列が返されます。例えば、CDATAセクション内の大量のテキストから、特定のキーワードやデータの一部だけを効率的に取り出したい場合に非常に有用です。

もし指定された $offset が文字データの全長を超えている場合や、$count が残りの文字データ長を超過している場合は、PHPの内部処理によって範囲が適切に調整され、利用可能な最大範囲の文字列が返されます。このメソッドは、XMLやHTMLドキュメントのデータ操作において、CDATAセクションのコンテンツを柔軟にプログラムで操作する上で重要な機能を提供します。

Copy
1<?php
2$dom = new DOMDocument();
3$cdata = $dom->createCDATASection("This is a CDATA section.");
4$substring = $cdata->substringData(8, 7); // "a CDATA" を抽出
5echo $substring;
6?>

int $offset, int $count

• int $offset: 抽出を開始する文字位置を指定する整数
• int $count: 抽出する文字数を指定する整数

string

CDATAセクションの指定された範囲の文字列を返します。