%XML_STRING_CREATE

Create an XML string instance

WSupported on Windows
USupported on Unix
VSupported on OpenVMS
NSupported in Synergy .NET
xml_string = %XML_STRING_CREATE

Return value

xml_string

The XML string instance created, or 0 if not successful. (XML_STRING_TYPE)

Discussion

%XML_STRING_CREATE creates an empty XML string. This is the first step you must take before you can parse XML data that arrives in a Synergy program as in-memory data, such as an alpha string or a D_HANDLE handle returned from the HTTP document transport API. You would then call one of the append routines (%XML_STRING_APPEND, %XML_STRING_APPENDDYN, or %XML_STRING_APPENDHANDLE) to add the data to the XML string you just created.

This function is defined as ^VAL.

Examples

See XML_to_Synergy_DBMS, available from Synergy CodeExchange in the Synergex Resource Center.