Find an element in an XML element list by tag

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
element = %XML_ELEMLIST_FINDTAG(elem_list, tag)

Return value


The XML element instance found, or 0 if not successful. (XML_ELEM_TYPE)



The XML element list instance. (XML_ELEMLIST_TYPE)


The tag name of the element to find. (a)


%XML_ELEMLIST_FINDTAG looks for the first element with the specified tag name in an XML element list. If you want to find subsequent elements with that tag name, you must manually iterate through the list.

You can alternatively retrieve an element by its name using %XML_ELEMLIST_FIND or by its index position using %XML_ELEMLIST_ITEM.

This function is defined as ^VAL.