@XMLCreate

This @Function creates a new, empty XML document.
The created XML document uses XML version 1.0. The supplied flags are stored in the created VSPECHXMLDOC (XMLD) handle and are inherited by XML handles derived from it later.
After processing has been completed, the XML document should be released using @XMLRelease.

FN Flags (Optional):
Numeric value containing options for further processing of the XML document.

BIT   DEC   HEX   BEDEUTUNG wenn gesetzt
01   000001   00001   XML_FLAG_OUTPUT_TRANSLATE_LMBCS   (Converts query results to LMBCS)
02   000002   00002   XML_FLAG_QUERY_TRANSLATE_UTF8   (Converts query parameters to UTF-8)
03   000004   00004   XML_FLAG_INPUT_TRANSLATE_UTF8   (Converts the input data to UTF-8 before parsing)
The flags can be combined and are inherited by derived handles.

Return Value:
On successful execution, the @Function returns a VSPECHXMLDOC (XMLD) handle referencing the newly created XML document.
If the XML document cannot be created or the Flags parameter is invalid, the @Function returns @ERROR.
The created document initially does not contain a root element. A root element can subsequently be created, for example, using @XMLCreateRoot.
After processing has been completed, the XML document should be released using @XMLRelease.

Example: @XMLCreate(Flags);

Flags := 7;
hXMLD := @XMLCreate(Flags);
hXMLRoot := @XMLCreateRoot(hXMLD;"customer");

…

@XMLRelease(hXMLD);

The example creates a new XML document using the specified flags and then adds a root element with the name "customer".

Note : This text was machine-translated and may contain inaccuracies.