Section 25.45. CharacterData.replaceData( ): replace characters of a Text or Comment node with a string

25.45. CharacterData.replaceData( ): replace characters of a Text or Comment node with a string

DOM Level 1 Core:

25.45.1. Synopsis

 void replaceData(unsigned long offset,                  unsigned long count,                  String arg)     tHRows DOMException; 

25.45.1.1. Arguments

offset

The character position within the Text or Comment node at which the replacement is to begin.

count

The number of characters to be replaced.

arg

The string that replaces the characters specified by offset and count.

25.45.1.2. Throws

This method may throw a DOMException with one of the following code values in the following circumstances:

INDEX_SIZE_ERR

offset is negative or greater than the length of the Text or Comment node, or count is negative.

NO_MODIFICATION_ALLOWED_ERR

The node is read-only and may not be modified.

25.45.2. Description

This method replaces count characters starting at position offset with the contents of the string arg. If the sum of offset and count is greater than the length of the Text or Comment node, all characters from offset on are replaced.

Notice that the insertData( ) and deleteData( ) methods are both special cases of this one.