Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
net.sf.saxon.dom.NodeOverNodeInfo
net.sf.saxon.dom.TextOverNodeInfo
Field Summary |
Fields inherited from class net.sf.saxon.dom.NodeOverNodeInfo | |
node |
Method Summary | |
void |
|
void |
|
String |
|
int |
|
String |
|
void |
|
boolean |
|
void |
|
Text |
|
void |
|
Text |
|
String |
|
public void appendData(String arg) throws DOMException
Append the string to the end of the character data of the node. DOM method: always fails.
- Parameters:
arg
- TheDOMString
to append.
public void deleteData(int offset, int count) throws DOMException
Remove a range of 16-bit units from the node. DOM method: always fails.
- Parameters:
offset
- The offset from which to start removing.count
- The number of 16-bit units to delete.
public String getData()
Get the character data of a Text or Comment node. DOM method.
public int getLength()
Get the length of a Text or Comment node. DOM method.
public String getWholeText()
Returns all text ofText
nodes logically-adjacent text nodes to this node, concatenated in document order.
For instance, in the example belowwholeText
on theText
node that contains "bar" returns "barfoo", while on theText
node that contains "foo" it returns "barfoo".
- Since:
- DOM Level 3
public void insertData(int offset, String arg) throws DOMException
Insert a string at the specified character offset. DOM method: always fails.
- Parameters:
offset
- The character offset at which to insert.arg
- TheDOMString
to insert.
public boolean isElementContentWhitespace()
Returns whether this text node contains element content whitespace, often abusively called "ignorable whitespace". The text node is determined to contain whitespace in element content during the load of the document or if validation occurs while usingDocument.normalizeDocument()
.
- Since:
- DOM Level 3
public void replaceData(int offset, int count, String arg) throws DOMException
Replace the characters starting at the specified 16-bit unit offset with the specified string. DOM method: always fails.
- Parameters:
offset
- The offset from which to start replacing.count
- The number of 16-bit units to replace.arg
- TheDOMString
with which the range must be replaced.
public Text replaceWholeText(String content) throws DOMException
Replaces the text of the current node and all logically-adjacent text nodes with the specified text. All logically-adjacent text nodes are removed including the current node unless it was the recipient of the replacement text.
This method returns the node which received the replacement text. The returned node is:
null
, when the replacement text is the empty string;- the current node, except when the current node is read-only;
- a new
Text
node of the same type (Text
orCDATASection
) as the current node inserted at the location of the replacement.
For instance, in the above example callingreplaceWholeText
on theText
node that contains "bar" with "yo" in argument results in the following:
Where the nodes to be removed are read-only descendants of anEntityReference
, theEntityReference
must be removed instead of the read-only nodes. If anyEntityReference
to be removed has descendants that are notEntityReference
,Text
, orCDATASection
nodes, thereplaceWholeText
method must fail before performing any modification of the document, raising aDOMException
with the codeNO_MODIFICATION_ALLOWED_ERR
.
For instance, in the example below callingreplaceWholeText
on theText
node that contains "bar" fails, because theEntityReference
node "ent" contains anElement
node which cannot be removed.
- Parameters:
content
- The content of the replacingText
node.
- Returns:
- The
Text
node created with the specified content.
- Since:
- DOM Level 3
public void setData(String data) throws DOMException
Set the character data of a Text or Comment node. DOM method: always fails, Saxon tree is immutable.
public Text splitText(int offset) throws DOMException
Break this node into two nodes at the specified offset, keeping both in the tree as siblings. DOM method, always fails.
- Parameters:
offset
- The 16-bit unit offset at which to split, starting from 0.
- Returns:
- The new node, of the same type as this node.
public String substringData(int offset, int count) throws DOMException
Extract a range of data from a Text or Comment node. DOM method.
- Parameters:
offset
- Start offset of substring to extract.count
- The number of 16-bit units to extract.
- Returns:
- The specified substring. If the sum of
offset
andcount
exceeds thelength
, then all 16-bit units to the end of the data are returned.