All Packages Class Hierarchy This Package Previous Next Index
Interface org.w3c.dom.CharacterData
- public interface CharacterData
- extends Node
The CharacterData
interface extends Node with a set of
attributes and methods for accessing character data in the DOM. For
clarity this set is defined here rather than on each object that uses
these attributes and methods. No DOM objects correspond directly to
CharacterData
, though Text
and others do inherit
the interface from it. All offset
s in this interface start
from 0.
-
appendData(String)
- Append the string to the end of the character data of the node.
-
deleteData(int, int)
- Remove a range of characters from the node.
-
getData()
- The character data of the node that implements this interface.
-
getLength()
- The number of characters that are available through
data
and
the substringData
method below.
-
insertData(int, String)
- Insert a string at the specified character offset.
-
replaceData(int, int, String)
- Replace the characters starting at the specified character offset with
the specified string.
-
setData(String)
-
-
substringData(int, int)
- Extracts a range of data from the node.
getData
public abstract String getData() throws DOMException
- The character data of the node that implements this interface. The DOM
implementation may not put arbitrary limits on the amount of data that
may be stored in a
CharacterData
node. However,
implementation limits may mean that the entirety of a node's data may
not fit into a single DOMString
. In such cases, the user
may call substringData
to retrieve the data in
appropriately sized pieces.
- Throws: DOMException
- NO_MODIFICATION_ALLOWED_ERR: Raised when the node is readonly.
- Throws: DOMException
- DOMSTRING_SIZE_ERR: Raised when it would return more characters than
fit in a
DOMString
variable on the implementation
platform.
setData
public abstract void setData(String data) throws DOMException
getLength
public abstract int getLength()
- The number of characters that are available through
data
and
the substringData
method below. This may have the value
zero, i.e., CharacterData
nodes may be empty.
substringData
public abstract String substringData(int offset,
int count) throws DOMException
- Extracts a range of data from the node.
- Parameters:
- offset - Start offset of substring to extract.
- count - The number of characters to extract.
- Returns:
- The specified substring. If the sum of
offset
and
count
exceeds the length
, then all
characters to the end of the data are returned.
- Throws: DOMException
- INDEX_SIZE_ERR: Raised if the specified offset is negative or greater
than the number of characters in
data
, or if the
specified count
is negative.
DOMSTRING_SIZE_ERR: Raised if the specified range of text does not
fit into a DOMString
.
appendData
public abstract void appendData(String arg) throws DOMException
- Append the string to the end of the character data of the node. Upon
success,
data
provides access to the concatenation of
data
and the DOMString
specified.
- Parameters:
- arg - The
DOMString
to append.
- Throws: DOMException
- NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
insertData
public abstract void insertData(int offset,
String arg) throws DOMException
- Insert a string at the specified character offset.
- Parameters:
- offset - The character offset at which to insert.
- arg - The
DOMString
to insert.
- Throws: DOMException
- INDEX_SIZE_ERR: Raised if the specified offset is negative or greater
than the number of characters in
data
.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
deleteData
public abstract void deleteData(int offset,
int count) throws DOMException
- Remove a range of characters from the node. Upon success,
data
and length
reflect the change.
- Parameters:
- offset - The offset from which to remove characters.
- count - The number of characters to delete. If the sum of
offset
and count
exceeds length
then all characters from offset
to the end of the data
are deleted.
- Throws: DOMException
- INDEX_SIZE_ERR: Raised if the specified offset is negative or greater
than the number of characters in
data
, or if the
specified count
is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
replaceData
public abstract void replaceData(int offset,
int count,
String arg) throws DOMException
- Replace the characters starting at the specified character offset with
the specified string.
- Parameters:
- offset - The offset from which to start replacing.
- count - The number of characters to replace. If the sum of
offset
and count
exceeds length
, then all characters to the end of the data are replaced (i.e., the
effect is the same as a remove
method call with the same
range, followed by an append
method invocation).
- arg - The
DOMString
with which the range must be
replaced.
- Throws: DOMException
- INDEX_SIZE_ERR: Raised if the specified offset is negative or greater
than the number of characters in
data
, or if the
specified count
is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.
All Packages Class Hierarchy This Package Previous Next Index