MoveXMLNode()

Syntax

Result = MoveXMLNode(*Node, *ParentNode [, *PreviousNode])

Moves the given XML node and all its contained text and children to a new location. This function can even be used to move nodes into a different XML tree. For copying a complete node to a new location CopyXMLNode() can be used.

Parameters

'*Node' specifies the node to move.
'*ParentNode' is the node into which to insert the node. To insert the node at the root of the tree, RootXMLNode() can be used here.
'*PreviousNode' specifies a childnode of '*ParentNode' after which the node should be inserted. If this value is 0 or not specified, the node is inserted as the first child of its parent. If this value is -1, the node is inserted as the last child of its parent.

The following rules must be followed for a successful move:
- The root node of a tree cannot be moved
- *ParentNode may not be of type #PB_XML_Comment or #PB_XML_CData
- *PreviousNode must be a direct child of *ParentNode (if it is specified)
- *Node and *PreviousNode cannot be equal
- *ParentNode cannot be equal to, or a child of *Node (a node cannot be moved into itself)
- If the XML tree already has a main node, only nodes other than #PB_XML_Normal and #PB_XML_CData can be inserted at the root level

Return value

Returns nonzero if the move was successfull or zero if the node could not be moved.

Supported OS

All