%XML_ELEMLIST_ADDLIST

Add a list of elements to an XML element list

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
status = %XML_ELEMLIST_ADDLIST(destid, sourceid)

Return value

status

One of the following values:

XML_SUCCESS = The elements are added successfully.

XML_FAIL = The elements are not added successfully.

Arguments

destid

The destination XML element list ID. (XML_ELEMLIST_TYPE)

sourceid

The source XML element list ID. (XML_ELEMLIST_TYPE)

Discussion

%XML_ELEMLIST_ADDLIST adds each of the elements in the source XML element list to the end of the destination XML element list.

This function is defined as ^VAL.

Examples

The example below adds a new element list to the root element’s element list.

    doc                 ,XML_DOC_TYPE
    root                ,XML_ELEM_TYPE
    elem1               ,XML_ELEM_TYPE
    elem2               ,XML_ELEM_TYPE
    elemlistroot        ,XML_ELEMLIST_TYPE
    elemlistnew         ,XML_ELEMLIST_TYPE

; Get a list of the children of root

    root = %xml_doc_getroot(doc)
    elemlistroot=%xml_elem_children(root)

; Create a new list of children 

    elemlistnew=%xml_elemlist_create()

    elem1=%xml_elem_create()
    elem2=%xml_elem_create()

    xcall xml_elem_setname(elem1, "Folgers")
    xcall xml_elem_setname(elem2, "MaxwellHouse")
    xcall xml_elemlist_add(elemlistnew, elem1)
    xcall xml_elemlist_add(elemlistnew, elem2)

; Add the new list to the existing list

    xcall xml_elemlist_addlist(elemlistroot, elemlistnew)