%XML_ELEMLIST_FINDTAG
Find an element in an XML element list by tag
WSupported on Windows
|
USupported on Unix
|
VSupported on OpenVMS
|
NSupported in Synergy .NET
|
element = %XML_ELEMLIST_FINDTAG(elem_list, tag)
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)
tag
The tag name of the element to find. (a)
Discussion
%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.