matlab.io.xml.dom.CDATASection 类

包： matlab.io.xml.dom

CDATA 节

自 R2021a 起

说明

matlab.io.xml.dom.CDATASection 类的一个对象定义一个 XML CDATA 节。CDATA 节包含未转义 XML 标记字符而串行化的文本内容。

matlab.io.xml.dom.Parser 对象将标记 <![CDATA[...]]> 转换为 CDATASection 对象。您可以在 CDATA 节标记中使用非转义字符。例如，您可以使用 > 代替 >。CDATA 节标记无需使用字符实体来指示 >、< 和其他字符，从而便于在 XML 文档中包含计算机代码和数学表达式。

matlab.io.xml.dom.CDATASection 类是 handle 类。

类属性

`ConstructOnLoad`	`true`
`HandleCompatible`	`true`

有关类属性的信息，请参阅类属性。

创建对象

使用 matlab.io.xml.dom.Document 对象的 createCDATASection 方法创建 matlab.io.xml.dom.CDATASection 对象。

属性

全部展开

`Length` — CDATA 节中的字符数
双精度值

CDATA 节中的字符数，指定为双精度值。

属性：

`GetAccess`	`public`
`SetAccess`	`immutable`
`Transient`	`true`
`NonCopyable`	`true`

`TextContent` — CDATA 节的文本内容
字符向量

CDATA 节的文本内容，指定为字符向量。

属性：

`GetAccess`	`public`
`SetAccess`	`public`

方法

全部展开

公共方法

`appendData`	`appendData(thisCDATASection,characters)` 在此 CDATA 节中字符数据的末尾追加字符。以字符向量或字符串标量形式指定 `characters`。
`cloneNode`	`copy = cloneNode(thisCDATASection,deep)` 创建此 CDATA 节的一个副本并返回该副本。如果 `deep` 为 `true`，则该副本为深拷贝。如果 `deep` 为 `false`，则该副本为浅拷贝。
`compareDocumentPosition`	`posEnum = compareDocumentPosition(thisCDATASection,otherNode)` 返回双精度值，该值对拥有 `thisCDATASection` 的文档中 `otherNode` 相对于 `thisCDATASection` 的位置进行编码。要解码返回的值 `posEnum`，请使用 MATLAB 表达式 `bitor(posEnum,POSITION_ENUM) == posEnum`，其中 `POSITION_ENUM` 是以下 `Comment` 方法之一： DOCUMENT_POSITION_FOLLOWING - 另一个节点跟在此 CDATA 节节点之后。 DOCUMENT_POSITION_PRECEDING - 另一个节点在此 CDATA 节节点之前。 DOCUMENT_POSITION_CONTAINED_BY - 此 CDATA 节节点包含另一个节点，后者的位置在此节点之后。 DOCUMENT_POSITION_CONTAINS - 另一个节点包含此 CDATA 节节点，前者的位置在此节点之前。 DOCUMENT_POSITION_DISCONNECTED - 两个节点彼此不相连。例如： import matlab.io.xml.dom.* d = Document("root"); root = getDocumentElement(d); cdata = createCDATASection(d,... "Example of a CDATA section"); appendChild(root,cdata); pos = compareDocumentPosition(cdata,root); if bitor(pos,cdata.DOCUMENT_POSITION_CONTAINS)... == pos disp("root contains CDATA section"); else disp("root does not contain CDATA section"); end
`deleteData`	`deleteData(thisCDATASection,offset,count)` 从此 CDATA 节的文本中删除某字符范围。`offset` 参数是要删除的第一个字符的索引（从 0 开始），指定为整数。`count` 参数是要删除的字符数，指定为整数。
`getBaseURI`	`uri = getBaseURI(thisCDATASection)` 以字符向量形式返回此 CDATA 节的基本 URI。该基本 URI 是拥有此 CDATA 节的文档的 URI。
`getData`	`str = getData(thisCDATASection)` 以字符向量形式返回此 CDATA 节中的字符数据。
`getLength`	`count = getLength(thisCDATASection)` 以双精度值形式返回此 CDATA 节中的字符数。
`getNextSibling`	`sibling = getNextSibling(thisCDATASection)` 返回此 CDATA 节节点的父级的子列表中跟在此 CDATA 节后面的节点。
`getNodeName`	`name = getNodeName(thisCDATASection)` 返回 `'#cdata-section'`。
`getNodeTypeName`	`name = getNodeTypeName(thisCDATASection)` 返回 `'CDATA_SECTION_NODE'`。
`getNodeValue`	`value = getNodeValue(thisCDATASection)` 以字符向量形式返回此 CDATA 节的内容。
`getOwnerDocument`	`doc = getOwnerDocument(thisCDATASection)` 以 `matlab.io.xml.dom.Document` 对象形式返回拥有此 CDATA 节的文档。所有者文档是创建或导入此 CDATA 节的文档。
`getParentNode`	`parent = getParentNode(thisCDATASection)` 返回此 CDATA 节的父级。如果此 CDATA 节没有父级，则该方法返回空节点。
`getPreviousSibling`	`sibling = getPreviousSibling(thisCDATASection)` 返回此 CDATA 节的父级的子列表中位于此 CDATA 节之前的节点。
`getTextContent`	`text = getTextContent(thisCDATASection)` 以字符向量形式返回此 CDATA 节中的字符数据。
`insertData`	`insertData(thisCDATASection,index,data)` 在从 0 开始的 `index` 参数指定的位置插入字符数据。以字符向量或字符串标量形式指定 `data`。
`isEqualNode`	如果 `otherNode` 指定的节点是 `CDATASection` 节点，并且具有与 `thisCDATASection` 相同的内容，则 `tf = isEqualNode(thisCDATASection,otherNode)` 返回 `true`。此方法测试节点的相等性，而不测试节点是否为同一对象的句柄。要测试相同性，请使用 `isSameNode` 方法。相同的节点也会相等，但相等的节点未必相同。在测试文档的相等性之前对它们进行标准化，因为标准化会影响相等性。
`isSameNode`	如果 `otherNode` 与 `thisCDATASection` 是同一个节点，则 `tf = isSameNode(thisCDATASection,otherNode)` 返回 `true`。
`replaceData`	`replaceData(thisCDATASection,index,count,data)` 用 `data` 指定的字符替换此 CDATA 节节点的文本内容中由 `count` 指定的字符数，从 `index`（从 0 开始）指定的位置开始。将 `index` 和 `count` 指定为整数。以字符向量或字符串标量形式指定 `data`。
`setData`	`setData(thisCDATASection,data)` 用 `data` 指定的文本替换此 CDATA 节节点的当前内容。以字符向量或字符串标量形式指定 `data`。
`setNodeValue`	`setNodeValue(thisCDATASection,value)` 将此 CDATA 节节点的文本内容设置为 `value` 指定的文本。以字符向量或字符串标量形式指定 `value`。
`setTextContent`	`setTextContent(thisCDATASection,textContent)` 将此 CDATA 节节点的文本内容设置为 `textContent` 指定的文本。以字符向量或字符串标量形式指定 `textContent`。
`splitText`	`newNode = splitText(thisCDATASection,index)` 将此 `CDATASection` 节点在指定的从 0 开始的索引处拆分为两个 `CDATASection` 节点，并返回新的 `CDATASection` 节点。拆分后，原始节点包含该索引之前的原始文本。新节点包含从该索引开始的原始文本。如果索引等于原始文本的长度，则新节点为空。如果此 `CDATASection` 节点有父级，则该方法会在父节点中此 `CDATASection` 节点的后面插入新节点。
`substringData`	`substringData(thisCDATASection,index,count)` 返回由 `index` 和 `count` 指定的字符。Index 是要返回的第一个字符的的位置（从 0 开始），`count` 是要返回的字符数。将 `index` 和 `count` 指定为整数。

示例

全部折叠

创建一个 CDATA 节以输出非转义标记字符

打开实时脚本

此示例说明 Text 节点和 CDATASection 节点中标记字符的串行化输出之间的差异。该示例创建一个 Text 节点和一个 CDATASection 节点，其文本内容包括标记字符 > 和 <。Text 节点的输出将标记字符表示为实体。CDATASection 节点的输出包括非转义标记字符。

创建一个 Document 对象并获取根元素。

import matlab.io.xml.dom.*

docNode = Document("root_element");
docRootNode = getDocumentElement(docNode);

创建一个包含代码 x > 1 | x < 2 的 Text 节点。将该节点追加到根元素。

tn = createTextNode(docNode,'x > 1 | x < 2');
appendChild(docRootNode,tn);

创建一个包含相同代码的 CDATASection 节点，并将该节点追加到根元素。

cdata = createCDATASection(docNode,'x > 1 | x < 2');
appendChild(docRootNode,cdata);

将 XML 写入一个字符串。

str = writeToString(DOMWriter,docNode)

str = 
'<?xml version="1.0" encoding="UTF-16" standalone="no" ?><root_element>x &gt; 1 | x &lt; 2<![CDATA[x > 1 | x < 2]]></root_element>'

版本历史记录

在 R2021a 中推出

另请参阅

matlab.io.xml.dom.Document