Release an XML element instance
|
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
NSupported in Synergy .NET
|
status = %XML_ELEM_DELETE(element)
Return value
status
XML_SUCCESS if the element was released successfully.
Arguments
element
The XML element instance to release. (XML_ELEM_TYPE)
Discussion
%XML_ELEM_DELETE releases an XML element and all of its subelements and attributes. You will rarely need to call this function, because the %XML_DOC_DELETE function releases all memory for an XML document, including all elements and attributes associated with the document. The only time you will need to release an individual element is when the element was explicitly created with %XML_ELEM_CREATE and was not added as data to a parent element (and therefore would not be released as part of a document or list).
Note that while %XML_ELEM_DELETE releases the element’s memory, it does not automatically remove the element from any element lists of which it is a member.
This function is defined as ^VAL.
