PHP Manual
Dom\CharacterData
文字データから指定した範囲のデータを抽出する

Dom\CharacterData::substringData

(PHP 8 >= 8.4.0)

Dom\CharacterData::substringData — 文字データから指定した範囲のデータを抽出する

説明

public function Dom\CharacterData::substringData(int $offset, int $count): string

指定した部分文字列を返します。

パラメータ

offset: 部分文字列の抽出開始位置のオフセット。
count: 抽出する文字数。

戻り値

指定された部分文字列を返します。 offset と count の和が文字列の長さをこえている場合、データの末尾までのすべての UTF-8 コードポイントが返されます。

エラー / 例外

以下のエラーコードで DOMException をスローします:

DOM_INDEX_SIZE_ERR: offset が負、あるいはデータ中の UTF-8 コードポイントの数より大きい場合、または count が負の場合に発生します。

参考

Dom\CharacterData::appendData() - ノードの文字データの最後に文字列を追加する
Dom\CharacterData::deleteData() - 指定した範囲の文字列を文字列データから削除する
Dom\CharacterData::insertData() - 指定した UTF-8 コードポイントのオフセットに、文字列を挿入する
Dom\CharacterData::replaceData() - 文字データの文字列の一部を置換する

関連キーワード:

CharacterData 抽出範囲 offset count substringData コードポイントオフセット replaceWith ChildNode 開始文字数末尾エラーコード DOMException 参考 appendData ノード最後 deleteData insertData 挿入 replaceData 一部

関連する関数・ページ:

dom-characterdata.deletedata dom-characterdata.insertdata dom-characterdata.appenddata dom-characterdata.replacedata dom-characterdata.remove dom-characterdata.replacewith