compact2, compact3

org.w3c.dom

Interface CharacterData

All Superinterfaces:

Node

All Known Subinterfaces:

CDATASection， Comment， Text， Text

public interface CharacterData
extends Node

CharacterData接口扩展的一组在DOM访问字符数据的方法和属性节点。为了清晰起见，这组定义在这里，而不是在使用这些属性和方法的每个对象上。没有DOM对象直接对应于 CharacterData，虽然 Text别人从它继承接口。所有的 offsets这个接口从 0。

在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() 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()

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为负数或大于 data 16位单元数，或者指定的 count是负的。
domstring_size_err：如果文本指定范围不适合 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为负数或大于 data 16位单元数。
no_modification_allowed_err：如果这个节点是只读了。

deleteData

void deleteData(int offset,
                int count)
         throws DOMException

从节点上删除一个16位单元的范围。在成功的基础上， data和 length反映变化。

参数

offset -从开始去除偏置。

count - 16位的单位数，删除。如果 offset和 count总和超过 length然后所有16位 offset单位从去年底的数据被删除。

异常

DOMException - index_size_err：提出如果指定 offset为负数或大于 data 16位单元数，或者指定的 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：提出如果指定 offset为负数或大于 data 16位单元数，或者指定的 count是负的。
no_modification_allowed_err：如果这个节点是只读了。