PHP Manual
DOMCharacterData
指定した UTF-8 コードポイントのオフセットに、文字列を挿入する

DOMCharacterData::insertData

(PHP 5, PHP 7, PHP 8)

DOMCharacterData::insertData — 指定した UTF-8 コードポイントのオフセットに、文字列を挿入する

説明

public function DOMCharacterData::insertData(int $offset, string $data): bool

offset の位置に、文字列 data を挿入します。

パラメータ

offset: 挿入する場所の文字オフセット。
data: 挿入する文字列。

戻り値

成功した場合に true を、失敗した場合に false を返します。

エラー / 例外

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

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

参考

DOMCharacterData::appendData() - ノードの文字データの最後に文字列を追加する
DOMCharacterData::deleteData() - 指定した範囲の文字列を文字列データから削除する
DOMCharacterData::replaceData() - 文字データの文字列の一部を置換する
DOMCharacterData::substringData() - 文字データから指定した範囲のデータを抽出する

関連キーワード:

DOMCharacterData 挿入コードポイントオフセット offset insertData deleteData 範囲 remove 場所成功エラーコード DOMException 参考 appendData ノード最後 replaceData 一部置換 substringData 抽出

関連する関数・ページ:

domcharacterdata.deletedata domcharacterdata.substringdata domcharacterdata.appenddata domcharacterdata.replacedata domcharacterdata.remove domcharacterdata.replacewith