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