compact2, compact3

org.w3c.dom

Interface CharacterData

All Superinterfaces:

Node

All Known Subinterfaces:

CDATASection ， Comment ， Text ， Text

public interface CharacterData
extends Node

CharacterData接口使用一组用于访问DOM中的字符数据的属性和方法来扩展Node。 为了清楚起见，这个集合是在这里定义的，而不是使用这些属性和方法的每个对象。 没有DOM对象直接对应于CharacterData ，尽管Text和其他人确实从它继承了接口。 全部offsets在此界面从0开始。

如DOMString DOMString所述，DOM中的文本字符串以UTF-16表示，即以16位为单位。 在下文中，术语16位单位在需要时使用，表示CharacterData的索引以16位为单位完成。

另见Document Object Model (DOM) Level 3 Core Specification 。

Field Summary

Fields inherited from interface org.w3c.dom.Node

ATTRIBUTE_NODE, CDATA_SECTION_NODE, COMMENT_NODE, DOCUMENT_FRAGMENT_NODE, DOCUMENT_NODE, DOCUMENT_POSITION_CONTAINED_BY, DOCUMENT_POSITION_CONTAINS, DOCUMENT_POSITION_DISCONNECTED, DOCUMENT_POSITION_FOLLOWING, DOCUMENT_POSITION_IMPLEMENTATION_SPECIFIC, DOCUMENT_POSITION_PRECEDING, DOCUMENT_TYPE_NODE, ELEMENT_NODE, ENTITY_NODE, ENTITY_REFERENCE_NODE, NOTATION_NODE, PROCESSING_INSTRUCTION_NODE, TEXT_NODE

方法摘要

Modifier and Type	Method and Description
void	appendData(String arg) 将字符串附加到节点的字符数据的末尾。
void	deleteData(int offset, int count) 从节点中删除一个16位的单位范围。
String	getData() 实现此接口的节点的字符数据。
int	getLength() 通过 data的16位单元 data和下面的 substringData方法。
void	insertData(int offset, String arg) 以指定的16位单位偏移量插入字符串。
void	replaceData(int offset, int count, String arg) 用指定的字符串替换从指定的16位单位偏移开始的字符。
void	setData(String data) 实现此接口的节点的字符数据。
String	substringData(int offset, int count) 从节点中提取一系列数据。

Methods inherited from interface org.w3c.dom.Node

appendChild, cloneNode, compareDocumentPosition, getAttributes, getBaseURI, getChildNodes, getFeature, getFirstChild, getLastChild, getLocalName, getNamespaceURI, getNextSibling, getNodeName, getNodeType, getNodeValue, getOwnerDocument, getParentNode, getPrefix, getPreviousSibling, getTextContent, getUserData, hasAttributes, hasChildNodes, insertBefore, isDefaultNamespace, isEqualNode, isSameNode, isSupported, lookupNamespaceURI, lookupPrefix, normalize, removeChild, replaceChild, setNodeValue, setPrefix, setTextContent, setUserData

方法详细信息

getData

String getData()
        throws DOMException

实现此接口的节点的字符数据。 DOM实现可能不会对可能存储在CharacterData节点中的数据量进行任意限制。 然而，实施限制可能意味着节点数据的整体可能不适合单个DOMString 。 在这种情况下，用户可以调用substringData以适当大小的片段检索数据。

异常

DOMException - DOMSTRING_SIZE_ERR：在实现平台上返回更多的字符，而不是匹配 DOMString变量时引发。

setData

void setData(String data)
      throws DOMException

实现此接口的节点的字符数据。 DOM实现可能不会对可能存储在CharacterData节点中的数据量进行任意限制。 然而，实施限制可能意味着节点数据的整体可能不适合单个DOMString 。 在这种情况下，用户可以调用substringData以适当大小的片段检索数据。

异常

DOMException - NO_MODIFICATION_ALLOWED_ERR：当节点只读时引发。

getLength

int getLength()

通过data的16位单位data和下面的substringData方法。 这可能具有零值，即CharacterData节点可能为空。

substringData

String substringData(int offset,
                     int count)
              throws DOMException

从节点中提取一系列数据。

参数

offset - 要提取的子字符串的起始偏移量。

count - 要提取的16位单位数。

结果

指定的子字符串。 如果offset和count的总和超过length ，则返回到数据结尾的所有16位单元。

异常

DOMException - INDEX_SIZE_ERR：如果指定的offset为负值或大于offset中的16位单元data ，或指定的count为负值则提升。
DOMSTRING_SIZE_ERR：如果指定的文本范围不适用于DOMString其DOMString 。

appendData

void appendData(String arg)
         throws DOMException

将字符串附加到节点的字符数据的末尾。 成功后， data提供访问指定的data和DOMString连接。

参数

arg - 附加的 DOMString 。

异常

DOMException - NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发。

insertData

void insertData(int offset,
                String arg)
         throws DOMException

以指定的16位单位偏移量插入字符串。

参数

offset - 要插入的字符偏移量。

arg - 要插入的 DOMString 。

异常

DOMException - INDEX_SIZE_ERR：如果指定的offset为负值或大于offset中的16位单元数，则data 。
NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发。

deleteData

void deleteData(int offset,
                int count)
         throws DOMException

从节点中删除一个16位的单位范围。 成功后， data和length反映了变化。

参数

offset - 从中开始删除的偏移量。

count - 要删除的16位单位数。 如果offset和count的总和超过length ，则从offset到数据结尾的所有16位单元都被删除。

异常

DOMException - INDEX_SIZE_ERR：如果指定的offset为负值或大于offset中的16位单元data ，或指定的count为负，则提升。
NO_MODIFICATION_ALLOWED_ERR：如果此节点是只读的，则引发。

replaceData

void replaceData(int offset,
                 int count,
                 String arg)
          throws DOMException

用指定的字符串替换从指定的16位单位偏移开始的字符。

参数

offset - 开始替换的偏移量。

count - 要替换的16位单位数。 如果offset和count的总和超过length ，则所有16位单位到数据结尾都被替换; （即效果与具有相同范围的remove方法调用相同，后跟append方法调用）。

arg - 必须更换范围的 DOMString 。

异常

DOMException - INDEX_SIZE_ERR: Raised if the specified offset is negative or greater than the number of 16-bit units in data, or if the specified count is negative.
NO_MODIFICATION_ALLOWED_ERR: Raised if this node is readonly.