DOM GET XML ELEMENT VALUE

Home

4D v20.6


DOM GET XML ELEMENT VALUE ( elementRef ; elementValue {; cDATA} )

Parameter	Type	Description
elementRef	String	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:

 C_TEXT($xml_Element_Ref)

 C_REAL($value)

 

 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.