DOM Get parent XML element
DOM Get parent XML element ( elementRef {; parentElemName {; parentElemValue}} ) : Text
| Parameter | Type | Description | |
|---|---|---|---|
| elementRef | Text | → | XML element reference |
| parentElemName | Text | ← | Name of parent XML element |
| parentElemValue | Text | ← | Value of parent XML element |
| Function result | Text | ← | Parent XML element reference |
Description
The DOM Get parent XML element command returns an XML reference to the “parent” of the XML element passed as reference in elementRef. This reference may be used with the other XML parsing commands.
The optional parentElemName and parentElemValue parameters, when passed, receive respectively the name and value of the parent element.
When you pass a root element in elementRef, the command returns the "#document" reference. The document node is the parent of a root element.
If you use this command on a document node, the command returns a null reference ("0000000000000000") and the OK variable is set to 0.
System variables and sets
If the command has been executed correctly, the system variable OK is set to 1. Otherwise, it is set to 0.
See also
DOM Get first child XML element
DOM Get last child XML element
DOM Get Root XML element
Properties
| Command number | 923 |
| Thread safe | ✓ |
| Modifies variables | OK |