4D Doc Center : SAX GET XML CDATA

Home

4D v14.3

SAX GET XML CDATA


SAX GET XML CDATA ( document ; value )

Parameter	Type	Description
document	DocRef	Reference of open document
value	Text, BLOB	Element value

Description

The SAX GET XML CDATA command gets the CDATA value of an XML element that exists in the XML document referenced in the document parameter. This command must be called with the XML CDATA SAX event. For more information about SAX events, refer to the description of the SAX Get XML node command.

Pass a value variable of the Text type if you want to retrieve data having a size greater than 32 KB (the database must be running in Unicode mode).

Compatibility note: Starting with 4D v12, CDATA contents encoded in base64 are automatically decoded by the SAX GET XML CDATA command, so it is not necessary to call the BASE64 DECODE command.

Example

Let's look at the following piece of XML code:

<RootElement>
   <Child>MyText<![CDATA[MyCData]]</Child>
</RootElement>

The following 4D code will return “MyCData” in vTextData:

 C_BLOB(vData)

 C_TEXT(vTextData)

 SAX GET XML CDATA(DocRef;vData)

 vTextData:=BLOB to text(vData;UTF8 C string)

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 and an error is generated.