XML DOM substringData() メソッド

定義と用法

substringData() メソッドは テキスト または コメント ノードからサブストリングを抽出します。

文法:

CharacterData.substringData(start,length)
パラメータ 説明
start 必須。返すサブストリングの最初の文字の位置。
length 必須。返すサブストリングの文字数。

返り値

Text や Comment ノードから start から始まる length 文字。

スロー

このメソッドは以下のコードを持つエラーをスローすることができます。 DOMException エラー

INDEX_SIZE_ERR - パラメータ start または length が負の数である場合、または length Text ノードや Comment ノードの長さを超えています。

DOMSTRING_SIZE_ERR - 指定されたテキスト範囲が長すぎて、ブラウザの JavaScript 実装では文字列に格納できません。

説明

このメソッドは、Text ノードや Comment ノードから start から始まる length 文字。このメソッドが役立つのは、ノードに含まれるテキストの文字数が、ブラウザの JavaScript 実装で入力できる文字列の最大文字数を超える場合に限ります。この場合、JavaScript プログラムは直接 Text ノードや Comment ノードの data 属性を使用できず、ノードテキストの短いサブストリングを使用する必要があります。実際のアプリケーションでは、このような状況はあまり発生しません。

関連ページ

XML DOM リファレンスマニュアル:Text.replaceData()

XML DOM リファレンスマニュアル:Comment.replaceData()