%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.