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
element
The XML element instance found, or 0 if not successful. (XML_ELEM_TYPE)
Arguments
elem_list
The XML element list instance. (XML_ELEMLIST_TYPE)
name
The value of the name attribute for the element you want to find. (a)
Discussion
%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.
