Find an element in an XML element list by name

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

Return value


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



The XML element list instance. (XML_ELEMLIST_TYPE)


The value of the name attribute for the element you want to find. (a)


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

You can alternatively retrieve an element by its tag using %XML_ELEMLIST_FINDTAG or by its index position using %XML_ELEMLIST_ITEM.

This function is defined as ^VAL.