%XML_STRING_CREATE

Create an XML string instance

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
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 xfspism2xml.zip, available from the Synergy CodeExchange in the Resource Center on the Synergex website.