THtmlIteratorRegEx() > Search methods

oTHtmlIteratorRegEx:find()

Searches the first HTML node matching the regular expressions.

Syntax

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

Arguments

<cRegExTagName>

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

<cRegExAttribute>

This is a character string holding the regular expression for matching the name of an HTML 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 HTML nodes.

Description

Method :find() defines the regular expressions for a THtmlIteratorRegEx 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 HTML node exists, the corresponding THtmlNode() object is returned, otherwise the return value is NIL. The search can be continued using the same regular expressions with method :next().