Gisle Aas > HTML-Tree-0.53 > HTML::TreeBuilder

Download:
HTML-Tree-0.53.tar.gz

Dependencies

Annotate this POD

CPAN RT

New  8
Open  8
Stalled  1
View/Report Bugs
Module Version: 2.08   Source   Latest Release: HTML-Tree-5.909-TRIAL

NAME ^

HTML::TreeBuilder - Parser that builds a HTML syntax tree

SYNOPSIS ^

 $h = new HTML::TreeBuilder;
 $h->parse($document);
 #...

 print $h->as_HTML;  # or any other HTML::Element method

DESCRIPTION ^

This is a parser that builds (and actually itself is) a HTML syntax tree.

Objects of this class inherit the methods of both HTML::Parser and HTML::Element. After parsing has taken place it can be regarded as the syntax tree itself.

The following method all control how parsing takes place. You can set the attributes by passing a TRUE or FALSE value as argument.

$p->implicit_tags

Setting this attribute to true will instruct the parser to try to deduce implicit elements and implicit end tags. If it is false you get a parse tree that just reflects the text as it stands. Might be useful for quick & dirty parsing. Default is true.

Implicit elements have the implicit() attribute set.

$p->ignore_unknown

This attribute controls whether unknown tags should be represented as elements in the parse tree. Default is true.

$p->ignore_text

Do not represent the text content of elements. This saves space if all you want is to examine the structure of the document. Default is false.

$p->warn

Call warn() with an appropriate message for syntax errors. Default is false.

SEE ALSO ^

HTML::Parser, HTML::Element

COPYRIGHT ^

Copyright 1995-1998 Gisle Aas. All rights reserved.

This library is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

AUTHOR ^

Gisle Aas <gisle@aas.no>

syntax highlighting: