%XML_ELEM_ADDCHILDREN

Add child elements to an XML element

WSupported on Windows

USupported on Unix

VSupported on OpenVMS

NSupported in Synergy .NET

status = %XML_ELEM_ADDCHILDREN(parent, elem_list)

Return value

status

One of the following values:

XML_SUCCESS = child elements are added successfully.

XML_FAIL = The child elements are not added successfully.

Arguments

parent

The XML element instance to which one or more children will be added. (XML_ELEM_TYPE)

elem_list

A list of child elements that will be added to the parent. (XML_ELEMLIST_TYPE)

Discussion

%XML_ELEM_ADDCHILDREN adds each of the XML elements in the specified list of child elements to the specified parent element. These children are appended to any existing children already in the parent.

This function is defined as ^VAL.

Examples

The following example adds two new children to the root element.

    doc         ,XML_DOC_TYPE
    root        ,XML_ELEM_TYPE
    elem1       ,XML_ELEM_TYPE
    elem2       ,XML_ELEM_TYPE
    elemlist    ,XML_ELEMLIST_TYPE

    root = %xml_doc_getroot(doc)

    elemlist = %xml_elemlist_create()
    elem1=%xml_elem_create()
    elem2=%xml_elem_create()

    xcall xml_elem_setname(elem1, "JavaCity")
    xcall xml_elem_setattribute(elem1, "location", "California")
    xcall xml_elemlist_add(elemlist, elem1)

    xcall xml_elem_setname(elem2, "SeattlesBest")
    xcall xml_elem_setattribute(elem2, "location", "Washington")
    xcall xml_elemlist_add(elemlist, elem2)

    xcall xml_elem_addchildren(root, elemlist)