%XML_ELEM_ADDCHILD

Add a child to an XML element

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

NSupported in Synergy .NET

status = %XML_ELEM_ADDCHILD(parent, child)

Return value

status

XML_SUCCESS if the XML element child is added successfully.

Arguments

parent

The XML element instance to which a child will be added. (XML_ELEM_TYPE)

child

The child XML element instance to add to the specified parent. (XML_ELEM_TYPE)

Discussion

After you create a child XML element and specify its name and attributes, you must add it to the parent element by calling %XML_ELEM_ADDCHILD.

This function is defined as ^VAL.

Examples

The example below adds a child element called field1 to the root element.

xcall xml_elem_addChild(root, field1)

Also see Example of assembling XML.