TXmlIteratorRegEx() > Search methods

oTXmlIteratorRegEx:find()

Searches the first XML node matching the regular expressions.

Syntax

:find( [<cRegExTagName>]  , ;
       [<cRegExAttribute>], ;
       [<cRegExValue>]    , ;
       [<cRegExData>]       ) --> oTXmlNode | NIL

Arguments

<cRegExTagName>

This is a character string holding the regular expression for matching the tag name of XML nodes.

<cRegExAttribute>

This is a character string holding the regular expression for matching the name of an XML attribute.

<cRegExValue>

The a regular expression to match an attribute value optionally defined with the character string <cRegExValue>.

<cRegExData>

This is an optional character string holding the regular expression for matching the textual data of XML nodes.

Description

Method :find() defines the regular expressions for a TXmlIteratorRegEx object and performs the initial search. Four different regular expressions can be defined to match 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 regular expressions with method :next().