文字データから指定した範囲のデータを抽出する

# DOMCharacterData::substringData

(PHP 5, PHP 7, PHP 8)

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

### 説明

public function DOMCharacterData::substringData(int `$offset`, int `$count`): string|false

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

### パラメータ

`offset`

  部分文字列の抽出開始位置のオフセット。

`count`

  抽出する文字数。

### 戻り値

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

### エラー / 例外

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

`DOM_INDEX_SIZE_ERR`

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

### 参考

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open