matlab.io.xml.dom.Text Class

appendData(thisText,characters) appends characters to the end of the text in this text node.

Specify characters as character vectors or string scalars.

docClone = cloneNode(thisText,deep) creates and returns a copy of this matlab.io.xml.dom.Text object. If deep is true, the copy is a deep copy. If deep is false, the copy is a shallow copy.

posEnum = compareDocumentPosition(textNode,otherNode) returns a double value that encodes the position of a node relative to the position of this text node in the document that owns the nodes. To decode the returned value, posEnum, use the MATLAB expression bitor(posEnum,POSITION_ENUM) == posEnum, where POSITION_ENUM is one of these Text methods:

For example:

import matlab.io.xml.dom.*
d = Document("root");
root = getDocumentElement(d);
text = createTextNode(d,"Hello");
appendChild(root,text);
pos = compareDocumentPosition(text,root);
if bitor(pos,text.DOCUMENT_POSITION_CONTAINS) == pos
   disp("root contains text");
else
   disp("root does not contain text");
end

deleteData(thisText,offset,count) deletes a range of characters from the text in this node. The offset argument is the zero-based index of the first character to delete, specified as an integer. The count argument is the number of characters to delete, specified as an integer.

name = getBaseURI(thisText) returns the base URI of this text node as a character vector. If the base URI is not known, the method returns an empty character array.

The base URI of a text node is the URI of the document that owns the text node.

data = getData(thisText) returns the character data in this node as a character vector.

count = getLength(thisText) returns the number of characters in the text content in this text node as a double.

getNextSibling(thisText) returns the node that follows this text node in the child list of the parent node of this text node.

type = getNodeType(thisText) returns the double 3, which indicates that this node is a text node.

This method provides compatibility with existing MATLAB^® code that is based on the W3C XML DOM standard.

For new MATLAB code, use isa to determine the type of a node. For example:

import matlab.io.xml.dom.*
d = Document('book');
para = createElement(d,"para");
txt = createTextNode(d,"hello");
if isa(txt,'matlab.io.xml.dom.Text')
    fprintf('This is a text node.\n');
end

value = getNodeValue(thisText) returns the text content of this text node as a character vector.

doc = getOwnerDocument(thisText) returns the document that owns this text node as a matlab.io.xml.dom.Document object. The owner document is the document that created or imported this text node.

getPreviousSibling(thisText) returns the node that precedes this text node in the child list of the parent node of this text node. If no node precedes this text node, the method returns an empty node.

insertData(thisText,index,data) inserts characters at the position specified by the zero-based index argument. Specify index as an integer and data as a character vector or string scalar.

tf = isEqualNode(thisText,otherNode) returns true if the node specified by otherNode is a text node and has the same text content as this text node.

This method tests for equality of nodes, not whether the nodes are handles to the same object. To test for sameness, use the isSameNode method.

Nodes that are the same are also equal, but nodes that are equal are not necessarily the same.

Normalize documents before testing them for equality because normalization can affect equality.

tf = isSameNode(thisText,otherNode) returns true if otherNode is the same node as thisText.

replaceData(thisText,index,count,data) replaces the number of characters specified by count in the text content of this text node, starting at the position specified by the zero-based index, with the characters specified by data.

Specify index and count as integers. Specify data as a character vector or string scalar.

setData(thisText,data) replaces the current content of this text node with the text specified by data.

Specify data as a character vector or string scalar.

setNodeValue(thisText,value) sets the text content of this text node to the text specified by value.

Specify value as a character vector or string scalar.

setTextContent(thisElem,textContent) sets the text content in this text node to the text specified by textContent.

Specify textContent as a character vector or string scalar.

newNode = splitText(thisText,index) splits this text node into two text nodes at the specified zero-based index and returns the new text node. After the split, the original text node contains the original text up to the index. The new node contains the original text from the index. If the index equals the length of the original text, the new node is empty. If this text node has a parent, the method inserts the new text node after this text node in the parent node.

substringData(thisText,index,count) returns the characters specified by index and count. Index is the zero-based position of the first character to return and count is the number of characters to return.

Specify index and count as integers.