%XML_ELEM_REMOVECHILDREN

Remove all child elements from an element

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
status = %XML_ELEM_REMOVECHILDREN(element)

Return value

status

One of the following values:

XML_SUCCESS = The child elements are removed successfully.

XML_FAIL = The child elements are not removed successfully.

Arguments

element

The XML element instance whose child elements will be removed. (XML_ELEM_TYPE)

Discussion

%XML_ELEM_REMOVECHILDREN removes all child elements from an XML element. This function is defined as ^VAL.

Examples

The example below removes all child elements from the root element.

    doc         ,XML_DOC_TYPE
    root        ,XML_ELEM_TYPE
    root = %xml_doc_getroot(doc)

    xcall xml_elem_removechildren(root)