MarkLogic 12 EA 1 Product Documentationxdmp.nodeInsertChild
xdmp.nodeInsertChild( parent as Node, new as Node ) as null
Summary
Adds a new last child to a node. For XML documents, only element nodes and document nodes can have children. For JSON documents, object nodes and array nodes can have children. Element nodes, object nodes, and array nodes cannot have document node children. Document nodes cannot have multiple roots. On-the-fly constructed nodes cannot be updated. The parameters must specify individual nodes and not node sets.
| Parameters | |
|---|---|
| parent | The parent node which will have a new child node. |
| new | The new child node to be inserted. |
Example
// create a document
declareUpdate();
xdmp.documentInsert("/example.xml",
fn.head(xdmp.unquote('<a/>')));
******
// insert a child of a
declareUpdate();
xdmp.nodeInsertChild(cts.doc("/example.xml").xpath("/a"),
fn.head(xdmp.unquote('<b>bbb</b>')).root);
******
// look at the new document
cts.doc("/example.xml");
=>
<?xml version="1.0" encoding="UTF-8"?>
<a><b>bbb</b></a>
Example
// create a document
declareUpdate();
xdmp.documentInsert("/example.xml",
fn.head(xdmp.unquote('<a/>')));
******
// insert an attribute as child of a
declareUpdate();
var n = new NodeBuilder();
node = n.addAttribute("b", "bbb").toNode();
xdmp.nodeInsertChild(cts.doc("/example.xml").xpath("/a"), node);
// look at the new document
cts.doc("/example.xml");
=>
<?xml version="1.0" encoding="UTF-8"?>
<a b="bbb"/>