DOM GET XML ELEMENT VALUE
DOM GET XML ELEMENT VALUE ( elementRef ; elementValue {; cDATA} )
| Parameter | Type | Description | |
|---|---|---|---|
| elementRef | Text | → | XML element reference |
| elementValue | Variable | ← | Value of the element |
| cDATA | Variable | ← | Contents of the CDATA section |
Description
The DOM GET XML ELEMENT VALUE command returns, in the elementValue parameter, the value of the XML element designated by elementRef. 4D will attempt to convert the value obtained into the same type as that of the variable passed as parameter. If the variable type is not defined, the value is returned in text type by default.
The optional cDATA parameter is used to retrieve the contents of the CDATA section(s) of the elementRef XML element. Like with the elementValue parameter, 4D will attempt to convert the value obtained into the same type as that of the variable passed as parameter, and if the variable type is not defined, the text type is used by default.
Note: If the element designated by elementRef is a BLOB processed by the DOM SET XML ELEMENT VALUE command, it has been automatically encoded in base64. Therefore the command will automatically attempt to decode it in base64.
Example
This method returns the value of the $xml_Element_Ref element:
var $xml_Element_Ref : Text
var $value : Real
DOM GET XML ELEMENT VALUE($xml_Element_Ref;$value)
System variables and sets
If the command has been correctly executed, the system variable OK is set to 1. If an error occurs, it is set to 0.
See also
DOM Get XML element
DOM GET XML ELEMENT NAME
DOM SET XML ELEMENT VALUE
Properties
| Command number | 731 |
| Thread safe | ✓ |
| Modifies variables | OK |