TXmlIteratorScan() > Search methods

oTXmlIteratorScan:find()

Searches the first XML node matching the search criteria.

Syntax

:find( [<cTagName>]  , ;
       [<cAttribute>], ;
       [<cValue>]    , ;
       [<cData>]       ) --> oTXmlNode | NIL

Arguments

<cTagName>

This is a character string holding the tag name of the XML node to search for.

<cAttribute>

This is a character string holding the name of an XML attribute to search for.

<cValue>

The attribute value to search is optionally defined with the character string <cValue>.

<cData>

This is an optional character string holding the textual data of an XML node to search.

Description

Method :find() defines the search criteria for a TXmlIteratorScan object and performs the initial search. The search criteria can be defined as any combination of tag name, attribute name, attribute value or textual data. If a matching XML node exists, the corresponding TXmlNode() object is returned, otherwise the return value is NIL. The search can be continued using the same search criteria with method :next().