THtmlIteratorScan() > Search methods

oTHtmlIteratorScan:find()

Searches the first HTML node matching the search criteria.

Syntax

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

Arguments

<cTagName>

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

<cAttribute>

This is a character string holding the name of an HTML 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 HTML node to search.

Description

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