xdmp.nodeInsertBefore

xdmp.nodeinsertbeforexdmpnodeinsertbefore

/apidoc/8.0/xdmp:node-insert-before.xml

Adds an immediately preceding sibling to a node.

The sibling node to be preceded by the new node.

sibling

Node

The new node to be inserted.

new

Node

null Attribute nodes cannot be preceded by non-attribute nodes. Non-attribute nodes cannot be preceded by attribute nodes. Element nodes cannot have document node children. Document nodes cannot have multiple roots. On-the-fly constructed nodes cannot be updated.

// create a document 

declareUpdate();
xdmp.documentInsert("/example.xml", xdmp.unquote(
    '<a><b>bbb</b></a>').next().value);

******
// add a c node before the b node 

declareUpdate();
xdmp.nodeInsertBefore(cts.doc("/example.xml").xpath("/a/b"),
    xdmp.unquote('<c>ccc</c>').next().value.root);

******
// look at the new document  

cts.doc("/example.xml");
 =>
<?xml version="1.0" encoding="UTF-8"?>
<a><c>ccc</c><b>bbb</b></a>