THtmlDocument() > Methods for searching and navigating

oTHtmlDocument:findFirst()

Locates the first HTML node containing particular data.

Syntax

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

Arguments

<cTagName>

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

<cAttributeName>

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

<cAttributeValue>

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

<cText>

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

Description

Method :findFirst() locates the first HTML node in the HTML document that matches the search criteria. If no parameter is passed, the first HTML 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().