%XML_ATTR_DELETE
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
NSupported in Synergy .NET
|
status = %XML_ATTR_DELETE(attr)
Return value
status
XML_SUCCESS if the attribute is successfully released.
Arguments
attr
The XML attribute instance to release. (XML_ATTR_TYPE)
Discussion
You will rarely need to call this function, because the %XML_DOC_DELETE function releases all memory for an XML document, including all attributes associated with the document. The only time you will need to release an individual attribute is when the attribute was explicitly created with %XML_ATTR_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_ATTR_DELETE releases the attribute’s memory, it does not automatically remove the attribute from any attribute lists of which it is a member.
This function is defined as ^VAL.