TXmlDocument() > Methods for searching and navigating

oTXmlDocument:findFirst()

Locates the first XML node containing particular data.

Syntax

:findFirst( [<cTagName>]        , ;
            [<cAttributeName>]  , ;
            [<cAttributeValue>] , ;
            [<cData>]             ) --> oTXmlNode | NIL

Arguments

<cTagName>

This is a character string holding the name of the XML node to find.

<cAttributeName>

This is a character string holding the name of an attribute of the XML node to find.

<cAttributeValue>

This is a character string holding the value of the attribute of the XML node to find.

<cData>

This is a character string holding the textual content of the XML node to find.

Description

Method :findFirst() locates the first XML node in the XML tree that matches the search criteria. If no parameter is passed, the first XML node in the tree is returned. Search criteria can be any combination of name, attribute and textual content. If no matching node is found, the return value is NIL.

If a matching node is found, the next node matching the same search criteria is returned from method :findNext().