%XML_ATTR_DELETE

Release an XML attribute

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.