%XML_ATTRLIST_REMOVE

Remove an attribute from an XML attribute list

WTSupported in traditional Synergy on Windows

WNSupported in Synergy .NET on Windows

USupported on UNIX

VSupported on OpenVMS

status = %XML_ATTRLIST_REMOVE(attr_list, attr) 

Return value

status

XML_SUCCESS if the attribute was removed.

Arguments

attr_list

The XML attribute list instance. (XML_ATTRLIST_TYPE)

attr

The XML attribute instance to remove. (XML_ATTR_TYPE)

Discussion

%XML_ATTRLIST_REMOVE removes an attribute from the XML attribute list but does not delete the attribute. If you remove an attribute from a list and don’t add it to another list, you must call %XML_ATTR_DELETE to delete the attribute and release its associated memory.

Examples

The example below assumes an XML attribute list called alist has an attribute whose name is attr1:

attr = %xml_attrlist_find(alist, "attr1")
if (attr)
  begin
    ret = %xml_attrlist_remove(alist, attr)
  end