Name: revXMLCopyNode

Type: command

Syntax: revXMLCopyNode <treeId>, <sourceNode>, <destinationNode> [, <location>] [, <relationship>]

Summary: Duplicates a node in an XML tree and copies it to the specified position

Introduced: 2.9

OS: mac,windows,linux,ios,android

Platforms: desktop,server,web,mobile

Security: disk

Example:
-- Duplicates myNode and puts it after the original
revXMLCopyNode tTreeId, "root/myNode", "root/myNode", "after", "sibling"

Parameters:
treeId: The number returned by the revXMLCreateTree or revXMLCreateTreeFromFile function when you created the XML tree.
sourceNode: The path of the node to be copied.
destinationNode: The path of the node that the sourceNode will be copied either into or alongside.
location: Either "before" or "after" and determines whether the copied node should be placed before or after its new sibling node. If no location is specified, the default is "after"
relationship: Either "sibling" or "child". This specifies the relationship that the sourceNode should have to the destinationNode after being copied. "sibling" means that the sourceNode will be placed alongside the destinationNode. "child" means that the sourceNode will be placed below the destinationNode (i.e. as a child of it). If no relationship is specified, the default is "child"

The result: If the <revXMLCopyNode> command encounters an error, the result is set to an error message beginning with "xmlerr". .

Description:
Use the <revXMLCopyNode> command to create a duplicate of a node in an xml tree.

>*Important:*  The <revXMLCopyNode> <command> is part of the <XML library>. To ensure that the <command> works in a <standalone application>, you must include this <Revolution custom library|custom library> when you create your <standalone application|standalone>. In the Inclusions section on the General screen of the <Standalone Application Settings> window, make sure "XML Library" is selected in the list of script libraries.

References: revXMLMoveNode (command), Standalone Application Settings (glossary), standalone application (glossary), command (glossary), XML library (library), Revolution custom library (library)
