%XML_ATTR_CREATE

Create an XML attribute

WSupported on Windows
USupported on Unix
VSupported on OpenVMS
NSupported in Synergy .NET
attr = %XML_ATTR_CREATE

Return value

attr

The XML attribute instance created, or 0 if not successful. (XML_ATTR_TYPE)

Discussion

An XML attribute is a characteristic of an XML element. For example, an attribute of a field element might be name or size.

Most of the time it is easier to use %XML_ELEM_SETATTRIBUTE, which defines an attribute’s name and value and assigns the attribute to an XML element, rather than %XML_ATTR_CREATE. If you create an attribute with %XML_ATTR_CREATE, you must also set its name and value with %XML_ATTR_SETNAME and %XML_ATTR_SETVALUE and then add it to an element’s attribute list using %XML_ATTRLIST_ADD.

Attributes explicitly created with this routine and not added as data to a parent element will need to be deleted using %XML_ATTR_DELETE.

This function is defined as ^VAL.