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

replaceDataメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2025年11月24日

基本的な使い方

replaceDataメソッドは、DOMTextノード内のテキストデータを指定されたオフセットと長さに基づいて、指定された文字列で置き換えるメソッドです。このメソッドは、DOM（Document Object Model）におけるテキストノードの内容を動的に変更するために使用されます。

具体的には、replaceData(int $offset, int $length, string $data) のように使用します。$offset は、置換を開始する位置を示す整数値で、0から始まるインデックスです。$length は、置換するデータの長さを指定する整数値です。$data は、元のテキストデータを置き換える新しい文字列です。

例えば、テキストノードの内容が "Hello World" で、replaceData(6, 5, "PHP") を実行すると、テキストノードの内容は "Hello PHP" に変更されます。これは、6番目の文字（"W"）から始まる5文字（"World"）を、文字列 "PHP" で置き換えることを意味します。

replaceDataメソッドは、テキストノードの内容を部分的に変更する際に非常に便利です。DOM操作において、テキストデータの更新や修正を行うための基本的な機能を提供します。$offset または $length が負の値である場合、または $offset + $length がノードのデータ長を超える場合、このメソッドは DOMException をスローします。システムエンジニアは、これらの例外処理を適切に行う必要があります。

構文(syntax)


1DOMText::replaceData(int $offset, int $count, string $data): void

引数(parameters)

int $offset, int $count, string $data

int $offset: 置換を開始するオフセット（開始位置）を整数で指定します。
int $count: 置換する文字数を整数で指定します。
string $data: 置換する新しい文字列を指定します。

戻り値(return)

bool

このメソッドは、指定されたオフセットから指定された長さの文字列を置き換える操作が成功したかどうかを示すブール値を返します。成功した場合は true、失敗した場合は false を返します。