%XML_ELEM_GETELEMENTSBYNAME
Get children of an XML element by tag
WTSupported in traditional Synergy on Windows
|
WNSupported in Synergy .NET on Windows
|
USupported on UNIX
|
VSupported on OpenVMS
|
elem_list = %XML_ELEM_GETELEMENTSBYNAME(element, tag_name)
Return value
elem_list
The XML element list of all children with the specified tag name directly under the specified XML element, or 0 if no children are found. (XML_ELEMLIST_TYPE)
Arguments
element
The XML element instance whose children will be listed. (XML_ELEM_TYPE)
tag_name
The tag name of the children to list. (a)
Discussion
%XML_ELEM_GETELEMENTSBYNAME uses a tag name to retrieve a list of child XML elements for the specified parent element. Element lists explicitly created with this routine will need to be deleted using %XML_ELEMLIST_DELETE.
This function is defined as ^VAL.
Examples
We’ll use the following portion of an XML document as an example:
<structure name="mystruct" > <group name="mygroup" /> <field name="f1" /> <field name="f2" /> </structure>
Assuming parent is the structure element,
%xml_elem_getElementsByName(parent, "field")
will return a list that contains two children, f1 and f2.
Also see Example of parsing XML.