Skip Headers

Oracle® XML API Reference 10g Release 1 (10.1) Part No. B10789-01 |
| Contents

## Text Interface

Table 4-12 summarizes the methods of available through the `Text` interface.

Table 4-12 Summary of Text Methods; DOM Package

Function | Summary
--- | ---
XmlDomSplitText | Split text node in to two.

### XmlDomSplitText

Splits a single text node into two text nodes; the original data is split between them. If the given node is not type text, or the offset is outside of the original data, does nothing and returns `NULL`. The offset is zero-based, and is in characters, not bytes. The original node is retained, its data is just truncated. A new text node is created which contains the remainder of the original data, and is inserted as the next sibling of the original. The new text node is returned.

Syntax

    xmltextnode* XmlDomSplitText(
       xmlctx *xctx,
       xmltextnode *textnode,
       ub4 offset)

Parameter | In/Out | Description
--- | --- | ---
    xctx
    IN
| XML context
    textnode
    IN
| `Text` node
    offset
    IN
| `0`-based character count at which to split text

Returns

`(xmltextnode *)` new text node

See Also: XmlDomGetCharData, XmlDomAppendData, XmlDomInsertData, XmlDomDeleteData, XmlDomReplaceData