%XML_GetElementsByTagName function

Function
The function returns the handle to the list of children of an XML element that match the given parameters.
Declaration
INT %XML_GetElementsByTagName(
    INT in node, 
    TEXT in  mask
 )
Parameters
nodeHandle to parent XML node.
maskSample element mask.
namespaceOptional parameter that defines the name of namespace or prefix of given element. Empty parameter is used providing that XML does not contain namespace. The value "*" is used, when there is not necessary explicitly take into account namespace and the searching is done only by mask of element name.
Return value
Handle to the list of XML elements.
Description
The function returns the handle to the list of children of an XML element, which match the defined mask of element name and namespace name or its prefix. The searching is executed recursively to depth.
Example
 INT _listElements
 
 _listElements := %XML_GetElementsByTagName(_doc, "elem*")
 ; e.g.: <element>, <element2>
 
 
 ; Returns handle to the list of elements that match the mask of name. It formally equals the first declaration.
 
 _listElements := %XML_GetElementsByTagName(_doc, "elem*","") 
 ; e.g.: <element> , <element2>
 
 
 ; Returns handle to the list of elements that match the mask of name, but ignores namespaces.
 
 _listElements := %XML_GetElementsByTagName(_doc, "elem*","*") 
 ; e.g.: <h:element>, <t:element2>, <element>
 
 
 ; Returns handle to the list of elements that equal the given mask and namespace or its prefix.
 
 _listElements := %XML_GetElementsByTagName(_doc, "elem*","t") 
 ; e.g.: <t:element>

Related pages:

XML file manipulation functions
Function arguments - types

Napíšte komentár